trpc-agent-go

环境要求

• Go 开发环境（需能执行 go run / go test 命令）
• Git（用于克隆仓库）
• 可用的模型服务访问凭证（示例使用 gpt-4o-mini，README 未给出配置方式）
• 网络可访问 GitHub 与模型服务接口

安装与启动步骤

1. 1克隆仓库

   从 GitHub 拉取 trpc-agent-go 源码到本地，README 给出的地址为准。

   git clone https://github.com/trpc-group/trpc-agent-go.git

   复制

2. 2进入项目目录

   切换到刚克隆下来的仓库根目录，后续命令都在此目录下执行。

   cd trpc-agent-go

   复制

3. 3进入示例目录

   README 的快速开始以 examples/runner 为第一个可运行示例。

   cd examples/runner

   复制

4. 4运行第一个 Agent

   用 go run 启动示例，指定模型 gpt-4o-mini 并开启流式输出；需确保模型凭证可用。

   go run . -model="gpt-4o-mini" -streaming=true

   复制

5. 5交互试用

   启动后与 Agent 对话，可尝试提问触发计算器与时间工具，验证流式与多轮记忆。

6. 6运行测试与检查

   README 的贡献指引要求跑通测试和 vet，确认本地环境无误。

   go test ./...
   go vet ./...

   复制

关键配置

如何确认成功

终端出现交互式聊天界面，Agent 能实时流式回复，并调用计算器、时间工具完成提问。

常见问题

注意事项

• README 的快速开始代码块中省略了第 2 步，实际只给出 clone、cd 和 go run 三步命令。
• 取消运行必须 cancel context 后继续 drain 事件通道，直接退出循环会导致 goroutine 泄漏或阻塞。
• 更多 runner 与 AG-UI 细节见 docs/mkdocs/en/runner.md 和 docs/mkdocs/en/agui.md。
• 使用模型前请自行确认模型服务凭证的配置方式，README 未提供具体配置说明。