API Swagger (OpenAPI)
Conecte qualquer API ao agente IA — sem escrever código
Importe qualquer API via URL Swagger/OpenAPI ou arquivo JSON e o agente IA aprende os endpoints automaticamente. Ele cria tools internas, entende parâmetros e começa a usar a API na conversa — tudo sem desenvolvimento.
Como funciona
Cole a URL do Swagger ou faça upload do JSON
Na tela de integrações do agente, cole a URL do Swagger (ex: https://api.exemplo.com/docs/openapi.json) ou faça upload do arquivo OpenAPI spec.
O Integration Loader analisa a spec
O sistema lê a especificação OpenAPI, identifica todos os endpoints, parâmetros, tipos de dados e autenticação necessária.
Tools são geradas automaticamente
Cada endpoint vira uma tool PydanticAI que o agente pode chamar. Nomes, descrições e parâmetros são extraídos direto da spec.
O agente usa a API na conversa
Durante o atendimento, o agente decide quando chamar cada endpoint com base no contexto da conversa. Sem regras manuais — a IA decide.
O que o agente pode fazer
Geração automática
Cada endpoint da spec vira uma tool com nome, descrição e parâmetros tipados automaticamente.
GET endpoints
Consultas de dados — o agente busca informações na API e responde ao cliente em linguagem natural.
POST endpoints
Criação de recursos — o agente pode criar registros, enviar dados e executar ações via API.
PUT/PATCH endpoints
Atualizações — o agente atualiza dados existentes na API conforme solicitado pelo cliente.
Autenticação automática
Suporte a API Key, Bearer Token e Basic Auth — configure uma vez e o agente usa em todas as chamadas.
Validação de parâmetros
Parâmetros são validados antes de enviar, evitando erros e garantindo chamadas corretas à API.
Casos de uso
Conectar o ERP da empresa — o agente consulta estoque, pedidos e clientes direto no sistema interno via API
Integrar com sistemas legados que já têm documentação Swagger — sem precisar desenvolver conectores customizados
Conectar múltiplas APIs ao mesmo agente — CRM, ERP, sistema de tickets, tudo via Swagger
Prototipar integrações em minutos — cole a URL, teste e valide antes de investir em desenvolvimento
Conectar plataformas de e-commerce que ainda não têm integração nativa — basta ter a API documentada
Sistemas de saúde, educação, logística — qualquer vertical que tenha API REST documentada pode ser integrada
⚡ Exemplo: da URL ao agente em 2 minutos
1. Cole a URL da spec
https://api.minhaloja.com/v1/openapi.json2. Tools geradas automaticamente
→ get_orders — Lista pedidos com filtros
→ get_order_by_id — Busca pedido por ID
→ get_products — Lista produtos do catálogo
→ create_ticket — Abre chamado de suporte
→ get_customer — Busca dados do cliente
3. Agente usa na conversa
O agente decide sozinho quando chamar cada tool. Cliente pergunta sobre pedido? Ele chama get_order_by_id. Quer abrir reclamação? Ele usa create_ticket.
Exemplo de conversa
Qual o status do meu pedido #4521?
Consultando seu pedido... O pedido #4521 está com status "Em transporte". Saiu do centro de distribuição ontem e a previsão de entrega é amanhã, dia 15/03. O código de rastreio é BR123456789. Quer que eu envie o link de rastreamento?
Sim! E pode alterar o endereço de entrega?
O link de rastreio é: https://rastreio.exemplo.com/BR123456789. Sobre o endereço, como o pedido já está em transporte, não consigo alterar automaticamente. Vou abrir um chamado para a equipe de logística verificar. Qual seria o novo endereço?