embabel-agent

环境要求

• JDK / JVM 环境（框架用 Kotlin 编写，运行在 JVM 上）
• Maven（README 称已有 Maven 和 OPENAI_API_KEY 时一分钟内即可跑起智能体）
• 已安装 uv/uvx（用于运行 project-creator 脚手架命令）
• OPENAI_API_KEY 环境变量，MCP 示例还需 Anthropic 密钥
• Docker（启动 Zipkin；运行 MCP 示例需 Docker Desktop 及 MCP 扩展）

安装与启动步骤

1. 1生成智能体项目

   用官方 project-creator 脚手架创建你自己的智能体项目，需预先安装 uv/uvx 与 Maven。

   uvx --from git+https://github.com/embabel/project-creator.git project-creator

   复制

2. 2克隆示例仓库

   拉取官方示例仓库并进入 Kotlin 脚本目录，也可直接用官方 Java/Kotlin 模板建仓。

   git clone https://github.com/embabel/embabel-agent-examples
   cd embabel-agent-examples/scripts/kotlin

   复制

3. 3运行示例交互环境

   执行 shell.sh 进入示例交互 shell，之后可在其中输入 execute 指令。

   ./shell.sh

   复制

4. 4执行智能体任务

   在 shell 内执行研究任务，此示例需同时配置 OpenAI 与 Anthropic 密钥及 Docker MCP 工具。

   execute "research the recent australian federal election. what is the position of the greens party?"

   复制

5. 5启动 Zipkin 追踪

   用 Docker 后台启动 Zipkin，端口映射 9411，作为观测后端。

   docker run -d -p 9411:9411 openzipkin/zipkin

   复制

6. 6运行应用并观测

   在项目根目录用 Maven Wrapper 启动应用，无需改代码即可获得追踪与指标。

   ./mvnw spring-boot:run

   复制

关键配置

如何确认成功

打开 http://localhost:9411 可看到 Agent/Action/ChatModel 调用链；示例 shell 能响应 execute 指令并输出结果。

常见问题

注意事项

• README 未给出 Maven 依赖坐标，Java/Kotlin 项目请基于官方模板仓库创建。
• 项目名发音为 Em-BAY-bel，作者为 Spring 的创造者。
• 更多示例与教程见 embabel-agent-examples 仓库，复杂真实案例见 Tripper 旅行规划智能体。
• 可访问 https://hub.embabel.com 用自然语言向文档智能体提问。