# AI Agent 工作约定（本仓库）

## MCP 能力说明（必读）

编排接口、工作流、跑批、执行历史时，**先阅读**：

**[`docs/mcp_tools_for_ai.md`](docs/mcp_tools_for_ai.md)**

该文档包含：工具决策表、鉴权要求、跑批三步、工作流节点约定、排障 Recipe。不要仅凭 `tools/list` 的短 description 猜测用法。

## 快速规则

- MCP 服务名：`quality-inspection-platform`（Streamable HTTP：`http://<主机>:8000/mcp`，需 `sto-` API Key）
- 写操作与执行类工具须 `sto-` API Key
- 任务开始：`catalog_snapshot`
- 跑批：`workflow_batch_create` → `workflow_batch_update` → `workflow_batch_run`
- 后端：`uvicorn app.main:app --host 127.0.0.1 --port 8000`

## 其它文档

- MCP 安装与 Cursor 配置：`docs/mcp_install.md`
- 人类调用示例（curl）：`docs/mcp_quickstart.md`