ClojureとADK for JavaでつくるAI Agent

はじめに

プロジェクトの概要

ゴールはADK for Java を Clojure から使って、簡単な計算ツールが使えるエージェントの実装までです。

実装

1. プロジェクトのセットアップ

まず、プロジェクトのディレクトリ構造を作成します。

code:./

your-project/

├── deps.edn

└── src/

└── hello_adk/

├── agent.clj

└── core.clj

code:deps.edn

:deps {org.clojure/clojure {:mvn/version "1.12.3"}

;; Ring HTTP server

info.sunng/ring-jetty9-adapter {:mvn/version "0.33.4"}

ring/ring-core {:mvn/version "1.15.3"}

;; JSON handling

metosin/jsonista {:mvn/version "0.3.13"}

;; ADK for Java

com.google.adk/google-adk {:mvn/version "0.4.0"}}

:aliases

:build {:deps {io.github.clojure/tools.build {:git/tag "v0.10.11" :git/sha "c6c670a"}}

:ns-default build}}}

code:build.clj

(ns build

(def class-dir "target/classes")

(def basis (b/create-basis {:project "deps.edn"}))

(defn clean

"Clean the target directory"

(b/delete {:path "target"}))

(defn compile-java

"Compile Java sources"

(b/javac {:src-dirs java-src-dirs

:class-dir class-dir

:basis basis

(defn build

"Clean and compile Java sources"

(clean nil)

(compile-java nil))

2. シンプルなLLMエージェントの実装

まずは、ツールを持たないシンプルなエージェントから始めます。質問に答えるだけのエージェントを作成します。

code:src/hello_adk/agent.clj

(ns hello-adk.agent

(defn create-agent

"Create a simple ADK agent without tools"

[]

(-> (LlmAgent/builder)

(.name "hello-agent")

(.description "A simple conversational agent")

(.instruction "You are a helpful assistant. Answer user questions politely and concisely.")

(.model "gemini-2.5-flash")

(.build)))

(defn query-agent

"Send a query to the agent and return the response"

(let [run-config (-> (RunConfig/builder) (.build))

runner (InMemoryRunner. agent-instance)

session (-> runner

(.sessionService)

(.createSession (.appName runner) "user1234")

(.blockingGet))

events (.runAsync runner (.userId session) (.id session) user-content run-config)

responses (atom [])]

;; Collect all final responses

(.blockingForEach events

(reify io.reactivex.rxjava3.functions.Consumer

(when (.finalResponse event)

(swap! responses conj (.stringifyContent event))))))

;; Return the last response

(last @responses)))

このあたりまではADKのドキュメントをJavaからClojureに翻訳するだけなので、そんなに難しくもないと思います。少しだけ面倒なのはADK for JavaではRxJavaを使っているのでRxJavaを適切に扱うのは少々面倒かもしれません（今回はそこまで踏み込まずブロックしてしまいます）。

3. HTTPサーバーの実装

次に、Ringを使ってHTTPサーバーを構築します。

code:src/hello_adk/core.clj

(ns hello-adk.core

(:gen-class))

(def agent-instance

"The ADK agent instance, created once at startup"

(delay (agent/create-agent)))

(defn hello-adk-handler

"Handle requests to /hello-adk endpoint"

(try

(let [body (json/read-value (slurp (:body request)) json/keyword-keys-object-mapper)

query (:query body "")

agent-response (agent/query-agent @agent-instance query)]

(-> {:status "success"

:query query

:response agent-response}

json/write-value-as-string

response

(content-type "application/json")))

(catch Exception e

(-> {:status "error"

:message (.getMessage e)}

json/write-value-as-string

response

(status 500)

(content-type "application/json")))))

(defn app-handler

"Main application handler"

(cond

(and (= uri "/hello-adk") (= request-method :post))

(hello-adk-handler request)

:else

(-> {:status "error"

:message "Not found"}

json/write-value-as-string

response

(status 404)

(content-type "application/json"))))

(defn -main

"Start the HTTP server on port 3000"

args

(println "Initializing ADK agent...")

@agent-instance

(println "Starting server on port 3000...")

(run-jetty app-handler {:port 3000 :join? true}))

code:bash

{"status":"success","query":"938271と19203を足した結果は","response":"938271と19203を足すと、957474になります。"}

4. 計算ツールの追加

code:src/java/hello_adk/BinaryOperationTool.java

package hello_adk;

import com.google.adk.tools.Annotations.Schema;

import clojure.lang.IFn;

import java.util.Map;

public class BinaryOperationTool {

private final IFn operationFn;

public BinaryOperationTool(IFn fn) {

this.operationFn = fn;

}

@Schema(description = "Perform a binary operation on two numbers")

public Map<String, String> operate(

@Schema(name = "x", description = "First number")

double x,

@Schema(name = "y", description = "Second number")

double y) {

Object result = operationFn.invoke(x, y);

return Map.of(

"x", String.valueOf(x),

"y", String.valueOf(y),

"result", String.valueOf(result)

);

}

}

5. エージェントにツールを統合

あわせてエージェントを作成する部分も修正しておきます。

code:src/hello_adk/agent.clj

(ns hello-adk.agent

(defn create-agent

"Create an ADK agent with a binary operation tool"

([]

(create-agent +)) ; デフォルトは足し算

;; 関数を渡してツールインスタンスを作成

(.. (LlmAgent/builder)

(name "calculator-agent")

(description "An agent that can perform binary operations on numbers")

(instruction "You are a helpful assistant that can perform calculations. Use the 'operate' tool when users ask you to calculate operations on two numbers.")

(model "gemini-2.5-flash")

(build)))))

;; query-agent関数は変更なし

ビルドと実行

ビルドしてつくったAI Agentを起動します。

code:bash

$ clj -P

$ clj -T:build build

$ gcloud auth application-default login

$ GOOGLE_GENAI_USE_VERTEXAI=TRUE \

GOOGLE_CLOUD_PROJECT=your-project-id \

GOOGLE_CLOUD_LOCATION=global \

clj -M:run

シンプルな会話（ツールなし）。

code:bash

-H "Content-Type: application/json" \

-d '{"query": "こんにちは！"}'

計算ツールを使った会話。

code:bash

-H "Content-Type: application/json" \

-d '{"query": "5と3を足してください"}'

まとめ

ADK for Javaを利用してAI Agentを作ることができました。これでClojureからADK for Javaを利用することは不可能ではないということが示せたかなと思います。ただ、説明を省略しましたがRxJavaとの繋ぎこみを適切に行うことや、Dev UIなどを起動しようとするともう少し面倒だったりします。

プロジェクトさえ立ち上げてしまえば、あとはほとんどClojureを書くだけの幸せが訪れるのでおすすめです。