内容
# 工具列表
Arch 是 Build、Evaluate、Optimize、Debug 和 Analyze 工作流的拟人化 Agent 平台 MCP 操作员。该软件包名称和工具名称对现有自动化保持稳定，但客户端现在将工具界面视为 Arch。
## 安装
```json
{
"mcpServers": {
"arch-agent-platform": {
"command": "npx",
"args": ["@koredotcom/agents-mcp-tools"],
"env": {
"AGENTS_URL": "https://agents.kore.ai"
}
}
}
}
```
将此内容添加到项目的 `.mcp.json` 或 `~/.claude/settings.json` 中。
现有的使用 `agent-platform-debug` 等 MCP 服务器密钥的配置可以保留该密钥；密钥是本地客户端配置。
### 环境 URL
| 环境 | URL |
| --- | --- |
| 生产环境 | `https://agents.kore.ai` |
| 开发环境 | `https://agents-dev.kore.ai` |
| 预发布环境 | `https://agents-staging.kore.ai` |
| 测试环境 | `https://agents-qa.kore.ai` |
| 本地环境 | `http://localhost:3112` |
在 `env` 块中设置 `AGENTS_URL`，或直接将 `serverUrl` 传递给 `platform_connect`。
## 工具
### Arch Build
Arch 创建和更改平台项目、代理、工具、配置、版本、部署和导入。
| 工具 | 描述 |
| --- | --- |
| `platform_projects` | 管理项目（列表、获取、创建、更新、删除） |
| `platform_agents` | 管理代理（列表、获取、保存 DSL） |
| `platform_versions` | 管理代理版本（列表、创建、获取、推广、差异） |
| `platform_deployments` | 管理部署（列表、创建、获取、退休、回滚） |
| `platform_tools` | 管理工具（列表、获取、创建、更新、删除、测试） |
| `platform_import_export` | 导入/导出项目 |
| `platform_config` | 管理项目和 LLM 配置 |
| `platform_workspaces` | 列出、切换和检查活动工作区 |
### Arch Evaluate
Arch 生成评估资产、运行评估工作流和读取 CI 证据。
| 工具 | 描述 |
| --- | --- |
| `platform_eval_personas` | 管理和生成评估角色 |
| `platform_eval_scenarios` | 管理和生成评估场景 |
| `platform_eval_evaluators` | 管理评估评估器和模板 |
| `platform_eval_sets` | 管理评估集 |
| `platform_eval_runs` | 管理评估运行、预检、案例和热图 |
| `debug_harness_logs` | 获取 Harness CI 执行日志 |
### Arch Optimize
Arch 验证包、检查编译器可见模型并驱动修复循环。
| 工具 | 描述 |
| --- | --- |
| `platform_validate_package` | 验证本地包和可选导入预览 |
| `platform_package_model` | 显示编译器可见的代理、工具、约束、引用和诊断 |
| `debug_lint_abl` | 运行 ABL 修复和设计检查 |
| `debug_why_transcript_failed` | 将转录症状与 ABL 文件/行原因关联 |
| `debug_diagnose_transcript` | 转录失败诊断的别名 |
### Arch Debug
Arch 连接到实时会话、跟踪故障和检查执行状态。
| 工具 | 描述 |
| --- | --- |
| `platform_connect` | 连接并验证到平台 |
| `debug_list_agents` | 按域列出可用代理 |
| `debug_load_agent` | 加载代理并创建调试会话 |
| `debug_send_message` | 向代理发送消息 |
| `debug_get_current_state` | 检查代理上下文、收集进度、流程状态 |
| `debug_traces` | 搜索跟踪事件（类型、文本、代理、错误） |
| `debug_get_span_tree` | 查看分层执行流程 |
| `debug_explain_decision` | 用上下文解释代理决策 |
| `debug_get_flow_graph` | 查看状态机图（JSON 或 Mermaid） |
| `debug_get_errors` | 获取错误、警告和升级 |
| `debug_list_active_sessions` | 列出可观察的会话 |
| `debug_session` | 订阅/取消订阅会话跟踪 |
### Arch Analyze
Arch 解释文档、诊断和系统健康信号。
| 工具 | 描述 |
| --- | --- |
| `debug_docs` | 获取或搜索 ABL 文档 |
| `debug_diagnose` | 诊断代理配置和执行问题 |
| `debug_analyze_session` | 自动会话诊断 |
## 身份验证
调用 `platform_connect` 时会自动进行身份验证：
1. **显式令牌** — 传递 `authToken` 参数
2. **存储凭证** — 读取 `~/.config/kore-platform/credentials.json`
3. **设备身份验证** — 打开浏览器并在同一个 `platform_connect` 调用中轮询直到批准完成
## 许可证
UNLICENSED
