zhanggangyong/agent_management
1
0
Fork 1
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 新增 Agent 资源配置参数支持

Browse Source 
- 新增 cpu_request, cpu_limit, memory_request, memory_limit, replicas 参数
- 创建 Agent 时可自定义 K8s 资源限制
- 更新 API 文档到 v2.1
This commit is contained in:
zhanggangyong
2026-01-30 11:56:39 +00:00
parent 8340f04dc9
commit 5a2f9a7ffc
3 changed files with 150 additions and 41 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/EXTERNAL_TOOL_API.md
+52 -13
View File
@@ -1,6 +1,6 @@
# 外部工具 API 文档
> **版本**: 2026-01-29 v2.0
> **版本**: 2026-01-30 v2.1
> **服务地址**: http://20.212.121.126
> **规范参考**: [Agent-Manager外部工具接口规范](http://gitee.ath.cx:3000/xiaohei/taiji-AI-PAD/src/branch/feature/chenchen/Docs/Agent-Manager%E5%A4%96%E9%83%A8%E5%B7%A5%E5%85%B7%E6%8E%A5%E5%8F%A3%E8%A7%84%E8%8C%83.md)
@@ -43,7 +43,23 @@
---
## 🆕 v2.0 新增功能
## 🆕 v2.1 新增功能
### 1. 资源配置支持
创建 Agent 时可以自定义 **CPU、内存、副本数** 等 K8s 资源配置：
| 参数 | 默认值 | 说明 |
|------|--------|------|
| `cpu_request` | `"100m"` | CPU 请求（如 100m, 500m） |
| `cpu_limit` | `"500m"` | CPU 限制（如 500m, 1000m） |
| `memory_request` | `"128Mi"` | 内存请求（如 128Mi, 256Mi） |
| `memory_limit` | `"512Mi"` | 内存限制（如 512Mi, 1Gi） |
| `replicas` | `1` | 副本数量（1-10） |
---
## 🆕 v2.0 功能
### 1. 回调功能（计费）
@@ -376,15 +392,20 @@ POST /external-tools/agents/create-with-tools
### 请求参数
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| name | string | ✅ | Agent 名称（1-63 字符，符合 K8s 命名规范） |
| template | string | ✅ | Agent 模板名称 |
| tool_refs | string[] | ✅ | 外部数据工具标识列表（**支持多个**） |
| config | object | ❌ | 资源配置 |
| env | object | ❌ | 环境变量 |
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| name | string | ✅ | - | Agent 名称（1-63 字符，符合 K8s 命名规范） |
| template | string | ✅ | - | Agent 模板名称 |
| tool_refs | string[] | ✅ | - | 外部数据工具标识列表（**支持多个**） |
| config | object | ❌ | `{}` | 其他配置（如 user_id） |
| env | object | ❌ | `{}` | 环境变量 |
| **cpu_request** | string | ❌ | `"100m"` | 🆕 CPU 请求（如 100m, 500m） |
| **cpu_limit** | string | ❌ | `"500m"` | 🆕 CPU 限制（如 500m, 1000m） |
| **memory_request** | string | ❌ | `"128Mi"` | 🆕 内存请求（如 128Mi, 256Mi） |
| **memory_limit** | string | ❌ | `"512Mi"` | 🆕 内存限制（如 512Mi, 1Gi） |
| **replicas** | int | ❌ | `1` | 🆕 副本数量（1-10） |
### 请求示例（多工具）
### 请求示例（多工具 + 资源配置）
```bash
curl -X POST http://20.212.121.126/external-tools/agents/create-with-tools \
@@ -399,7 +420,12 @@ curl -X POST http://20.212.121.126/external-tools/agents/create-with-tools \
],
"config": {
"user_id": "550e8400-e29b-41d4-a716-446655440000"
}
},
"cpu_request": "200m",
"cpu_limit": "1000m",
"memory_request": "256Mi",
"memory_limit": "1Gi",
"replicas": 2
}'
```
@@ -420,6 +446,13 @@ curl -X POST http://20.212.121.126/external-tools/agents/create-with-tools \
"domain_url": "http://agent-multi-tool-agent-ad2b92.taijiagnet.com",
"ip_url": "pending"
},
"resources": {
"cpu_request": "200m",
"cpu_limit": "1000m",
"memory_request": "256Mi",
"memory_limit": "1Gi",
"replicas": 2
},
"tools_attached": 3,
"repo_url": "http://gitee.ath.cx:3000/zhanggangyong/agent-multi-tool-agent-ad2b92",
"image_name": "agnettaiji.azurecr.io/ai-agents/agent-multi-tool-agent-ad2b92:latest",
@@ -675,7 +708,7 @@ echo "工具1: $TOOL1"
echo "工具2: $TOOL2"
```
### 2. 创建包含多工具的 Agent
### 2. 创建包含多工具的 Agent（带资源配置）
```bash
AGENT_RESULT=$(curl -s -X POST http://20.212.121.126/external-tools/agents/create-with-tools \
@@ -684,11 +717,17 @@ AGENT_RESULT=$(curl -s -X POST http://20.212.121.126/external-tools/agents/creat
\"name\": \"my-multi-tool-agent\",
\"template\": \"custom_agent\",
\"tool_refs\": [\"$TOOL1\", \"$TOOL2\"],
\"config\": {\"user_id\": \"user-123\"}
\"config\": {\"user_id\": \"user-123\"},
\"cpu_request\": \"200m\",
\"cpu_limit\": \"1000m\",
\"memory_request\": \"256Mi\",
\"memory_limit\": \"1Gi\",
\"replicas\": 2
}")
AGENT_REF_ID=$(echo $AGENT_RESULT | jq -r '.agent_ref_id')
echo "Agent Ref ID: $AGENT_REF_ID"
echo "Resources: $(echo $AGENT_RESULT | jq '.resources')"
```
### 3. 轮询构建状态