使用命令行¶

Supported in ADKPython v0.1.0TypeScript v0.2.0Go v0.1.0Java v0.1.0

ADK 提供了一个交互式终端界面来测试你的智能体。这对于快速测试、脚本化交互和 CI/CD 流水线非常有用。

ADK Run

运行智能体¶

使用以下命令在 ADK 命令行界面中运行你的智能体:

PythonTypeScriptGoJava

adk run my_agent

npx @google/adk-devtools run agent.ts

go run agent.go

创建一个 AgentCliRunner 类(参见 Java 快速入门)并运行:

mvn compile exec:java -Dexec.mainClass="com.example.agent.AgentCliRunner"

这将启动一个交互式会话,你可以在其中输入查询并直接在终端中查看智能体响应:

Running agent my_agent, type exit to exit.
[user]: What's the weather in New York?
[my_agent]: The weather in New York is sunny with a temperature of 25°C.
[user]: exit

会话选项¶

adk run 命令包含用于保存、恢复和重放会话的选项。

保存会话¶

要在退出时保存会话:

adk run --save_session path/to/my_agent

系统会提示你输入会话 ID,会话将保存到 path/to/my_agent/<session_id>.session.json。

你也可以预先指定会话 ID:

adk run --save_session --session_id my_session path/to/my_agent

恢复会话¶

要继续之前保存的会话:

adk run --resume path/to/my_agent/my_session.session.json path/to/my_agent

这会加载之前的会话状态和事件历史记录,显示它,并允许你继续对话。

重放会话¶

要在没有交互式输入的情况下重放会话文件:

adk run --replay path/to/input.json path/to/my_agent

输入文件应包含初始状态和查询:

{
  "state": {"key": "value"},
  "queries": ["What is 2 + 2?", "What is the capital of France?"]
}

存储选项¶

选项	描述	默认值
`--session_service_uri`	自定义会话存储 URI	`.adk/session.db` 下的 SQLite
`--artifact_service_uri`	自定义工件存储 URI	本地 `.adk/artifacts`

使用存储选项的示例¶

adk run --session_service_uri "sqlite:///my_sessions.db" path/to/my_agent

所有选项¶

选项	描述
`--save_session`	退出时将会话保存到 JSON 文件
`--session_id`	保存时使用的会话 ID
`--resume`	要恢复的已保存会话文件的路径
`--replay`	用于非交互式重放的输入文件的路径
`--session_service_uri`	自定义会话存储 URI
`--artifact_service_uri`	自定义工件存储 URI