Pular para o conteúdo

Casos de usoAgentes

Agentes que você pode rastrear, limitar e parar.

Uma execução de agente são dezenas de chamadas de modelo e de ferramentas. Envie-as por uma chave de gateway e um id de trace: cada etapa em uma única linha do tempo, cada ferramenta a partir de uma definição que você aprovou e um limite de gastos que a execução não consegue ultrapassar.

Trace checkout-123 · agente de triagemExemplo
Etapa 1 · modeloclaude-sonnet-5.5 · 200 · 1.8 s
Etapa 2 · ferramentagithub_list_issues · 200 · 0.6 s
Etapa 3 · ferramentagithub_close_issue · recusada, não concedida
Etapa 4 · modeloclaude-sonnet-5.5 · 200 · 1.1 s

Execução de exemplo. O INFRO não executa nenhuma ferramenta; seus servidores MCP e as contas deles continuam sendo seus.

O problema

Sem um plano de controle

  • Cada agente guarda o token de todos os servidores de ferramentas na própria configuração.
  • A definição de uma ferramenta pode mudar no servidor e o agente a segue.
  • Uma execução em loop é notada na fatura.

Com o INFRO

  • As credenciais de ferramentas ficam com o INFRO; os agentes enviam a chave de gateway deles.
  • As ferramentas são servidas a partir de definições que um administrador aprovou e fixou.
  • Cada chave de agente tem um limite, e cada execução é um único trace.

Como funciona

  1. Registre seus servidores de ferramentas uma vez

    Um administrador adiciona cada servidor MCP com o token dele e aprova as ferramentas. Os agentes nunca veem a credencial do servidor.

  2. Permissão por chave

    Negado por padrão: dê à chave de um agente as ferramentas de leitura de um servidor, todas elas ou algumas nomeadas. Rotacionar a chave mantém as permissões dela.

  3. Envie um id de trace

    Chamadas de modelo e de ferramentas com o mesmo X-INFRO-Trace-Id voltam como uma única execução de GET /v1/traces, com resultado, latência e custo por etapa.

O que você recebe

Cada um é documentado, e cada um diz qual plano o inclui. Quando nenhum plano é citado, está em todos os planos.

  • Um trace por execução

    Chamadas de modelo e de ferramentas com o mesmo id de trace são devolvidas como uma única execução, cada etapa com o resultado e a latência.

    Documentação
  • Ferramentas aprovadas e fixadasA partir do Business

    Os agentes recebem a definição que um administrador aprovou; uma ferramenta que muda no servidor é recusada até alguém revisá-la.

    Documentação
  • Permissões por chaveA partir do Business

    Negado por padrão. Conceda a uma chave as ferramentas de leitura de um servidor, todas as ferramentas dele ou algumas nomeadas.

    Documentação
  • Um limite por agente

    A chave do agente tem um teto que a execução não consegue ultrapassar; a próxima requisição é recusada antes da chamada ao provedor.

    Documentação
  • GuardrailsA partir do Business

    Verificações por padrões em prompts, respostas, argumentos e resultados de ferramentas: bloquear, mascarar ou sinalizar. A detecção pode deixar coisas passar.

    Documentação
  • Botões de desligamento em todos os planos

    Desative um servidor, bloqueie uma ferramenta ou interrompa todo o tráfego de ferramentas em uma única ação auditada. Desligar o acesso nunca depende de plano.

    Documentação

Para quem é

  • Desenvolvedores de agentesUma linha do tempo por execução em vez de cinco dashboards, e o acesso a ferramentas definido fora do código do agente.
  • Equipes de plataformaCredenciais de ferramentas em um só lugar, concedidas por chave, com um log de cada chamada.
  • SegurançaA definição de uma ferramenta não pode mudar sob um agente sem revisão, e cada chamada pode ser desligada.

Perguntas frequentes

O INFRO executa as minhas ferramentas?

Não. O INFRO encaminha cada chamada ao seu próprio servidor MCP com a credencial que você registrou e a registra. Os servidores e as contas deles continuam sendo seus.

Os guardrails impedem a injeção de prompt?

Não. Definições fixadas, permissões e guardrails reduzem o que uma instrução injetada consegue alcançar; eles não detectam nem impedem a injeção em si.

Quais frameworks de agentes funcionam?

Qualquer cliente MCP que fale Streamable HTTP e envie um header Authorization, inclusive o OpenAI Agents SDK e o Claude Agent SDK. As chamadas de modelo usam os formatos OpenAI ou Anthropic que eles já enviam.

O contrato completo está na Documentação do gateway MCP, e todas as outras perguntas estão no FAQ.

Começar

Experimente nas suas próprias contas de provedor.

Conecte um provedor, crie uma chave do gateway e mude uma URL base. Seus provedores continuam cobrando você diretamente; 0% de margem sobre os gastos com modelos.