• STATE
  • RESET
  • FLOW
  • HUMAN

Como depurar a lógica de agentes com sua IA

Conecte o Voiceflow ao seu cliente de IA para analisar dados de sessões em tempo real e corrigir caminhos interrompidos. Com a conexão feita, seu agente pode entrar no fluxo da conversa para identificar exatamente onde ocorreu o erro.

Pergunte à IA sobre esta página

Resposta rápida

Como posso usar minha IA para depurar diálogos no Voiceflow?

Sua IA extrai dados da sessão atual para ver quais variáveis estão definidas e onde o usuário travou. Ela pode limpar dados incorretos ou resetar variáveis para testar um caminho limpo. Veja como a lógica falha no detalhamento abaixo.

Resultados da depuração

Onde cada problema é identificado.

A IA categoriza suas sessões de depuração com base no que encontra nos dados da sessão.

STATE

Inspeção de variáveis

A IA lê o estado atual da sessão para encontrar variáveis incompatíveis. Você terá uma visão clara dos dados que causam o erro de lógica.

RESET

Limpeza de sessão

A IA apaga variáveis específicas da sessão para remover entradas incorretas. Isso permite reiniciar um teste sem precisar limpar o cache manualmente.

FLOW

Verificação de caminho

A IA compara o estado atual do usuário com a lógica planejada. Ela identifica exatamente em qual nó o usuário está.

HUMAN

Intervenção manual

A IA sinaliza loops lógicos que não consegue resolver sozinha. Nesses casos, você precisará ajustar os nós diretamente no designer de fluxo.

O fluxo

O que sua IA faz quando a tarefa chega.

A IA atua como um observador externo e depurador para o seu agente Voiceflow.

  1. Inspecionar dados da sessão

    Seu agente extrai as variáveis do usuário e sua posição no fluxo para entender o que está acontecendo agora.

    get_state

  2. Simular interação

    A IA envia uma mensagem ao agente para acionar ramos lógicos específicos e observar a resposta.

    interact

  3. Limpar variáveis incorretas

    Quando um teste falha por causa de uma variável errada, a IA remove esse dado específico para resetar o contexto.

    delete_state

  4. Confirmar novo estado

    Após corrigir uma variável, a IA salva o estado atualizado para que você continue testando o caminho corrigido.

    save_state

Teste

Copie estes comandos para começar.

Use estes prompts para iniciar a depuração dos seus fluxos no Voiceflow.

Pontos de partida

Estes são apenas exemplos. Substitua os nomes de variáveis ou IDs de usuário pelos valores reais do seu projeto no Voiceflow.

Voiceflow Connector

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

Link do conectorhttps://edge.vinkius.com/vk_preview_l22Y6YFkjLlbfmb2bwNvq56Y3lGMb9ioSh3t5jM5/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 — Voiceflow capabilities are ready to use.
Configuração · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "voiceflow-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_l22Y6YFkjLlbfmb2bwNvq56Y3lGMb9ioSh3t5jM5/mcp"
    }
  }
}
Copie no chat04

  • Verifique o estado atual da sessão do usuário para entender por que a variável 'order_status' está vazia.

  • Interaja com o agente Voiceflow e diga que quero cancelar minha assinatura para ver se o fluxo é acionado.

  • Delete o estado 'user_type' desta sessão para que eu possa testar o fluxo de onboarding novamente.

  • Salve o estado atual após eu atualizar a variável 'discount_code' para testar a lógica do checkout.

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

Comece aqui

Conecte o Voiceflow uma vez e comece a perguntar.

Basta vincular sua conta uma única vez. Suas credenciais ficam criptografadas e você pode começar a depurar imediatamente pelo seu cliente de IA.

Conectar Voiceflow à sua IA

FAQ

Como funciona esta tarefa.

  • 01

    A IA pode alterar os nós do canvas no Voiceflow?

    Não. A IA só interage com os dados e estados da sessão. Você deve mover os nós no designer do Voiceflow manualmente.

  • 02

    A IA pode excluir meu projeto inteiro?

    Não. As ferramentas permitem apenas que a IA gerencie estados de sessão e interaja com conversas ativas.

  • 03

    Posso usar isso para automatizar respostas de usuários?

    Sim, você pode usar a ferramenta de interação para acionar caminhos específicos enviando mensagens ao agente.

  • 04

    A IA tem acesso às minhas chaves de API?

    Não. Suas credenciais são criptografadas e gerenciadas pelo Vinkius; a IA vê apenas os dados retornados pelas ferramentas.

  • 05

    A IA pode criar novas variáveis para mim?

    Não. A IA só pode gerenciar, salvar ou excluir dados de estado já existentes dentro de uma sessão.

  • Mais dúvidas sobre o Voiceflow? A página do Connector responde. Veja tudo o que o Voiceflow Connector pode fazer

Conecte Voiceflow ao Claude, Cursor, ChatGPT e outros