# Schema notes (生成自 Task 3 schema 校准)

## skills.tools[] 条目字段

来源 schema：`swagger.AgentConfigSkillTool` / `skillvalobj.SkillTool`（两个定义一致）

```json
{
  "tool_box_id": "<工具箱 ID>",
  "tool_id": "<工具 ID>",
  "tool_timeout": 300,
  "intervention": false,
  "intervention_confirmation_message": "",
  "result_process_strategies": [],
  "tool_input": []
}
```

**必填字段（required）：** `tool_box_id`、`tool_id`

`tool_input[]` 条目（`swagger.AgentConfigSkillToolInput`）：

```json
{
  "input_name": "<参数名>",
  "input_type": "string|file|object",
  "enable": true,
  "map_type": "fixedValue|var|model|auto",
  "map_value": "<值>",
  "input_desc": "",
  "children": []
}
```

## skills.skills[] 条目字段

来源 schema：`swagger.AgentConfigSkillSkill`

```json
{
  "skill_id": "<skill ID>"
}
```

## skills.agents[] 条目字段（顺带记录）

来源 schema：`swagger.AgentConfigSkillAgent`

```json
{
  "agent_key": "<agent key>",
  "agent_version": "<版本>",
  "agent_timeout": 300,
  "intervention": false,
  "intervention_confirmation_message": "",
  "agent_input": [],
  "llm_config": {},
  "data_source_config": {}
}
```

**必填字段（required）：** `agent_key`

## skills 顶层结构

来源 schema：`swagger.AgentConfigSkills`

```json
{
  "tools":  [...],
  "agents": [...],
  "skills": [...],
  "mcps":   [...]
}
```

## 来源

- 现网 agent：`null`（扫描 19 个 agent，全部 `skills.tools = []`，`skills.skills = []`）
- swagger schema：`swagger.AgentConfigSkillTool`、`skillvalobj.SkillTool`
  来自 `http://10.110.223.168:13020/swagger/doc.json`（agent-factory pod，host `115.190.186.186`）
- 日期：2026-04-28
