Qué obtienes
- Un agente que llama a la API, generado a partir de la especificación: configuraciones de llamadas HTTP agrupadas por etiqueta, la canalización y el despliegue
- Filtrado de endpoints, sustitución de la URL base y propagación de la cabecera de autenticación
- La opción de añadir las herramientas de un servidor MCP junto a las generadas
- Herramientas que puedes revisar, comparar y versionar, porque son configuración
Cómo funciona en EDDI
- Entrega la especificación OpenAPI a EDDI mediante la herramienta MCP
create_api_agentoPOST /administration/agents/setup-api. - Incluye en la lista permitida las operaciones que debe tener el agente. Un endpoint no declarado no se puede llamar.
- EDDI genera las configuraciones de llamadas HTTP, construye la canalización completa y despliega el agente.
- Mantén las credenciales como referencias
${vault:...}. - Pon puerta a las escrituras con
http.post:*,http.put:*,http.patch:*,http.delete:*y exceptúa las lecturas conhttp.get:*.
Configuración
Extraída de la documentación de EDDI. Los marcadores como your-agent-id deben sustituirse por tus propios valores.
{
"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"
}
}
}Gobernanza
- Los patrones de aprobación pueden apuntar a lo que llama una herramienta (
http.post:*), lo cual sigue siendo correcto cuando cambia un operationId. - La plataforma protege las llamadas salientes contra SSRF y path traversal.
- Por REST,
setup-apiacepta unhitlConfig, de modo que un agente puede aprovisionarse con sus herramientas de escritura tras puerta desde la primera versión. La herramienta MCP no puede establecerlo. - Las decisiones quedan en el registro de auditoría.
Conviene saber
- Una herramienta de escritura generada recibe todo el cuerpo de la petición como un único parámetro
requestBody.
¿Necesitas que lo construyan y lo operen por ti?
EDDI Solutions construye y mantiene conectores, opera EDDI como instancia gestionada o co-operada, y te da soporte en tu propia nube o en local.
Hablar con EDDI Solutions ↗Integraciones relacionadas
La configuración y el comportamiento de esta página siguen la documentación de EDDI, comprobada el 2026-10-14. Los nombres de campo y los valores por defecto pueden cambiar entre versiones, así que confírmalos en la documentación de tu versión.