O que você recebe
- Um agente que chama a API, gerado a partir da especificação: configurações de chamadas HTTP agrupadas por tag, o pipeline e a implantação
- Filtragem de endpoints, substituição da URL base e propagação do cabeçalho de autenticação
- A opção de adicionar as ferramentas de um servidor MCP ao lado das geradas
- Ferramentas que você pode revisar, comparar e versionar, porque são configuração
Como funciona no EDDI
- Entregue ao EDDI a especificação OpenAPI pela ferramenta MCP
create_api_agentou porPOST /administration/agents/setup-api. - Inclua na lista de permitidos as operações que o agente deve ter. Um endpoint não declarado não pode ser chamado.
- O EDDI gera as configurações de chamadas HTTP, monta o pipeline completo e implanta o agente.
- Mantenha as credenciais como referências
${vault:...}. - Coloque portão nas escritas com
http.post:*,http.put:*,http.patch:*,http.delete:*e isente as leituras comhttp.get:*.
Configuração
Extraída da documentação do EDDI. Marcadores como your-agent-id devem ser substituídos pelos seus próprios 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"
}
}
}Governança
- Os padrões de aprovação podem endereçar o que uma ferramenta chama (
http.post:*), o que continua correto quando um operationId muda. - As chamadas de saída são protegidas contra SSRF e path traversal pela plataforma.
- Via REST, o
setup-apiaceita umhitlConfig, de modo que um agente pode ser provisionado com suas ferramentas de escrita com portão desde a primeira versão. A ferramenta MCP não consegue defini-lo. - As decisões ficam no registro de auditoria.
Bom saber
- Uma ferramenta de escrita gerada recebe o corpo inteiro da requisição como um único parâmetro
requestBody.
Precisa que construam e operem isso para você?
A EDDI Solutions constrói e mantém conectores, opera o EDDI como instância gerenciada ou co-operada e oferece suporte na sua própria nuvem ou on-premises.
Fale com a EDDI Solutions ↗Integrações relacionadas
A configuração e o comportamento desta página seguem a documentação do EDDI, verificada em 2026-10-14. Nomes de campos e valores padrão podem mudar entre versões, portanto confirme-os na documentação da sua versão.