你将获得
- 根据规范生成的 API 调用代理：按标签分组的 HTTP 调用配置、管道和部署
- 端点过滤、基础 URL 覆盖，以及认证请求头透传
- 可在生成的工具之外再添加 MCP 服务器的工具
- 工具本身就是配置，因此可以审阅、对比差异并进行版本管理
在 EDDI 中如何工作
- 通过
create_api_agentMCP 工具或POST /administration/agents/setup-api，把 OpenAPI 规范提供给 EDDI。 - 用允许列表列出代理应具备的操作。未声明的端点无法被调用。
- EDDI 生成 HTTP 调用配置，构建完整的管道并部署代理。
- 凭据以
${vault:...}引用的形式保存。 - 用
http.post:*,http.put:*,http.patch:*,http.delete:*为写操作设置审批，并用http.get:*豁免读操作。
配置
摘自 EDDI 文档。诸如 your-agent-id 之类的占位符需要你自行替换。
{
"targetServerUrl": "https://api.example.com/v1",
"httpCalls": [
{
"name": "list-open-orders",
"saveResponse": true,
"responseObjectName": "order",
"request": {
"method": "GET",
"path": "/orders",
"queryParams": { "status": "open" },
"headers": { "Authorization": "Bearer ${vault:orders-api-token}" }
}
}
]
}{
"hitlConfig": {
"toolApprovals": {
"requireApproval": [
"http.post:*",
"http.put:*",
"http.patch:*",
"http.delete:*"
],
"exempt": [
"http.get:*"
],
"approvalTimeout": "PT30M",
"timeoutPolicy": "AUTO_REJECT"
}
}
}治理
- 审批模式可以针对工具所调用的对象（
http.post:*），因此在 operationId 变化后仍然有效。 - 平台会保护出站调用，防范 SSRF 和路径遍历。
- 通过 REST，
setup-api接受hitlConfig，因此可以在配置代理时，从第一个版本起就为其写入工具设置审批。MCP 工具无法设置它。 - 决定会记录到审计账本中。
须知
- 生成的写入工具会把整个请求体作为一个
requestBody参数。
相关集成
本页的配置和行为依据 EDDI 文档，核对日期为 2026-10-14。字段名称和默认值可能随版本变化，请在所用版本的文档中确认。