• TRIAGEM
  • REPARO
  • RELATÓRIO
  • HUMANO

Como depurar erros de integração com seu AI

Conecte o Prismatic ao seu agente. Após a conexão, você pode resolver problemas em fluxos de trabalho interrompidos pedindo para o agente analisar os logs.

Pergunte à IA sobre esta página

Resposta rápida

Como depuro erros de integração com meu AI?

Você pede ao seu agente para extrair os logs de uma execução específica que falhou. Ele usa a ferramenta fetch_logs para ler os detalhes do erro e explica exatamente o que aconteceu. Você recebe um diagnóstico claro dos pontos de falha.

Onde sua depuração termina.

Resultados da análise.

O AI processa os dados brutos nestes resultados específicos.

TRIAGEM

Pontos de falha identificados

O agente lê os logs e aponta o passo exato onde o fluxo parou. Você visualiza a mensagem de erro específica que causou a interrupção.

REPARO

Análise de causa raiz

O agente compara os dados de entrada com o esquema esperado. Ele informa se o erro foi causado por um payload inválido ou por um timeout.

RELATÓRIO

Resumo de erros

O agente agrupa várias entradas de log em uma única explicação. Você recebe um resumo direto do padrão de erro encontrado.

HUMANO

Intervenção manual

O agente identifica quando um erro exige que você corrija dados manualmente ou atualize uma chave de API. Ele sinaliza esses momentos para você não perder tempo tentando adivinhar.

O fluxo

O que seu AI faz quando ocorre uma falha.

O agente faz o trabalho pesado de vasculhar os dados brutos de execução.

  1. Acesso aos logs

    O agente acessa o Prismatic para buscar os dados de execução específicos que você solicitou.

    fetch_logs

  2. Análise de erros

    Ele varre os logs recuperados em busca de códigos de erro, stack traces e mensagens de status de falha.

    fetch_logs

  3. Contextualização

    O agente analisa as entradas de log ao redor para entender o que aconteceu imediatamente antes da falha.

    fetch_logs

  4. Sugestão de correção

    O agente traduz o erro técnico em uma sugestão prática para você consertar o fluxo de trabalho.

    fetch_logs

Teste

Copie estes comandos para começar.

Use estes prompts para iniciar a depuração.

Pontos de partida

Substitua o texto entre colchetes pelos IDs específicos do seu fluxo ou execução.

Prismatic Connector

Tudo pronto. Escolha seu cliente MCP e siga as instruções de configuração.

Link do conectorhttps://edge.vinkius.com/vk_preview_Jp8xQVyawqmk1kh1SNDCvDluadVzruFklDLm4lQl/mcp

Claude Desktop

Siga os passos abaixo para conectar em segundos.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Prismatic capabilities are ready to use.
Configuração · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "prismatic-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_Jp8xQVyawqmk1kh1SNDCvDluadVzruFklDLm4lQl/mcp"
    }
  }
}
Copie no chat04

  • Busque os logs da execução ID [ID] e me diga por que ela falhou.

  • Analise os logs do meu fluxo [Nome do Fluxo] e encontre o erro.

  • Verifique os logs de execução recentes de [Nome do Fluxo] e resuma os últimos três erros.

  • Por que a execução de [Nome do Fluxo] falhou no passo [Nome do Passo]? Verifique os logs.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Comece aqui

Conecte o Prismatic uma vez e pronto.

Clique no link para conectar sua conta. Suas credenciais ficam criptografadas e você pode começar a perguntar sobre seus fluxos de trabalho imediatamente.

Conectar Prismatic ao seu AI

FAQ

Como funciona a depuração

  • 01

    O AI pode corrigir o erro automaticamente?

    Não. O agente apenas lê os logs e informa o que aconteceu. Você precisa realizar as alterações reais no seu fluxo de trabalho ou nos seus dados.

  • 02

    O AI pode excluir execuções que falharam?

    Não. O agente tem permissão apenas para buscar logs. Ele não pode excluir, editar ou modificar qualquer dado dentro do Prismatic.

  • 03

    O AI tem acesso a todos os meus dados de fluxo?

    O agente só vê os dados que ele recupera através da ferramenta fetch_logs quando você solicita especificamente.

  • 04

    Posso usar isso com o Claude?

    Sim, desde que você esteja usando um cliente compatível com MCP, como o Claude Desktop.

  • 05

    E se os logs forem muito grandes?

    O agente tentará buscar apenas os segmentos relevantes dos logs para encontrar o erro sem ultrapassar o limite de contexto.

  • Mais dúvidas sobre o Prismatic? Veja tudo o que o MCP do Prismatic pode fazer

Conecte Prismatic ao Claude, Cursor, ChatGPT e outros