Initial commit: bbc-reader with 1 tools - README.md

2026-01-30 14:51:57 +00:00
commit aca93a2609
1 changed files with 98 additions and 0 deletions
@@ -0,0 +1,98 @@
+# bbc-reader-5331ce
+
+Agent with 1 external tools
+
+## 自动生成信息
+
+- 生成时间: 2026-01-30T14:51:56.650101
+- 生成方式: Agent Manager 动态生成
+- 框架: agent_templates/agents/_template
+- 参考: [cicd-AKS](http://gitee.ath.cx:3000/xiaohei/cicd-AKS)
+
+## 包含工具
+
+- **jina_reader**: 使用 Jina Reader API 爬取网页内容，返回干净的 markdown 格式
+
+## API 端点
+
+### REST API
+- `GET /` - 服务信息
+- `GET /health` - 健康检查
+- `GET /tools` - 列出可用工具
+- `POST /tools/call` - 调用工具
+
+### MCP 端点
+- `POST /mcp` - MCP HTTP 端点
+- `GET /mcp/sse` - MCP SSE 端点
+- `POST /mcp/sse` - MCP SSE POST 端点
+
+## 调用示例
+
+```bash
+# 健康检查
+curl http://localhost:8000/health
+
+# 列出工具
+curl http://localhost:8000/tools
+
+# 调用工具
+curl -X POST http://localhost:8000/tools/call \
+  -H "Content-Type: application/json" \
+  -H "api-key: your-api-key" \
+  -d '{"tool_name": "example_tool", "parameters": {}}'
+
+# MCP 调用
+curl -X POST http://localhost:8000/mcp \
+  -H "Content-Type: application/json" \
+  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'
+```
+
+## 环境变量
+
+- `API_PORT`: 服务端口 (默认: 8000)
+- `API_HOST`: 服务地址 (默认: 0.0.0.0)
+- `OPENAI_API_KEY`: AI 模型 API Key
+- `OPENAI_BASE_URL`: AI 模型 API 端点
+- `MODEL_NAME`: AI 模型名称
+- `TOOL_API_KEY`: 工具 API 密钥 (如需要)
+
+## CI/CD 配置
+
+本仓库配置了 Gitea Actions (self-hosted runner)，推送到 main 分支后会自动：
+1. 构建 Docker 镜像 (ARM64)
+2. 推送到 Azure Container Registry
+3. 部署到 AKS 集群
+
+### 必需的 Secrets
+
+在 Gitee 仓库设置中配置以下 Secrets:
+
+| Secret 名称 | 说明 | 值 |
+|-------------|------|-----|
+| `ACR_LOGIN_SERVER` | ACR 登录服务器 | `agnettaiji.azurecr.io` |
+| `ACR_USERNAME` | ACR 用户名 | `agnettaiji` |
+| `ACR_PASSWORD` | ACR 密码 | *(配置为仓库Secret)* |
+| `AZ_CLIENT_ID` | Azure 服务主体 Client ID | `fb306798-2cfe-4ac9-ba48-eab7bc71bcfe` |
+| `AZ_CLIENT_SECRET` | Azure 服务主体密钥 | *(配置为仓库Secret)* |
+| `AZ_TENANT_ID` | Azure 租户 ID | `263c3ff6-1be5-4141-8308-b188464fb297` |
+| `AZ_SUBSCRIPTION_ID` | Azure 订阅 ID | `c6c47e4c-f5f4-49f8-b26f-7728862c17d6` |
+| `AZ_RG` | AKS 资源组名称 | `taiji-ai-pda` |
+| `AZ_AKS` | AKS 集群名称 | `taiji-ai-pda` |
+
+## 自动部署
+
+CI/CD 会自动：
+1. 构建 Docker 镜像 (ARM64)
+2. 推送到 Azure Container Registry
+3. 部署到 AKS 集群
+4. 创建 DNS 记录
+
+部署后可通过以下方式访问：
+- 命名空间: `agent-bbc-reader-5331ce`
+- 服务: `bbc-reader-5331ce-service`
+- **公网域名**: `http://bbc-reader-5331ce.taijiagnet.com`
+
+
+## 许可证
+
+MIT License