DotBot API 模式的 Python 使用示例。DotBot 暴露标准 OpenAI Chat Completions API,可直接使用 openai Python SDK 调用。
pip install -r requirements.txt所有示例默认连接 http://localhost:8080,请确保 DotBot 已启动 API 模式:
{
"Api": {
"Enabled": true,
"Port": 8080
}
}修改示例文件顶部的 DOTBOT_URL 和 API_KEY 以匹配你的服务器配置。
| 文件 | 说明 |
|---|---|
| basic_chat.py | 基本对话(非流式) |
| streaming_chat.py | 流式输出 |
| multi_turn_chat.py | 多轮对话(交互式 REPL) |
| human_in_the_loop.py | Human-in-the-Loop 审批流程 |
human_in_the_loop.py 演示了交互式审批流程。需要将服务器配置为 ApprovalMode: "interactive":
{
"Api": {
"Enabled": true,
"ApprovalMode": "interactive"
}
}当 Agent 执行敏感操作(如文件写入、Shell 命令)时,操作会暂停并等待 API 客户端通过 /v1/approvals 端点进行审批。
流程:
- 客户端发送聊天请求(Agent 开始执行)
- Agent 遇到需要审批的操作 → 暂停
- 客户端轮询
GET /v1/approvals获取待审批列表 - 用户审批或拒绝 →
POST /v1/approvals/{id} - Agent 恢复执行
详见 API 模式指南。