• DADOS
  • BUSCA
  • ESTRUTURA
  • HUMANO

Como depurar a recuperação RAG com seu agente de IA

Conecte o Cognita ao seu agente para inspecionar os dados enviados ao contexto. Você verá exatamente os fragmentos que fundamentam as respostas do seu modelo.

Pergunte à IA sobre esta página

Resposta rápida

Por que minha IA está trazendo o contexto errado?

Você pode usar seu agente para extrair fragmentos de texto específicos e verificar as coleções originais. Isso permite identificar se o problema é a qualidade dos dados ou uma busca mal formulada. Você terá uma visão clara de todo o fluxo de recuperação.

Resultados da depuração.

Onde cada problema é identificado.

O agente aponta exatamente onde o processo de recuperação está falhando.

DADOS

Fragmentos ruins identificados

A IA encontra segmentos de texto que não condizem com sua intenção. Você saberá quais partes dos documentos estão gerando ruído.

BUSCA

Refinamento de consulta

Ao ver o que o agente busca, você pode reescrever seus prompts. Melhore os resultados ajustando a forma como o agente pesquisa.

ESTRUTURA

Saúde da coleção

A IA inspeciona como seus dados estão organizados. Você verá se o seu banco vetorial carece do contexto necessário para ser útil.

HUMANO

Correções manuais necessárias

A IA sinaliza onde os dados de origem estão corrompidos. Você precisará intervir para limpar os documentos ou reindexar os arquivos.

O fluxo

O que sua IA faz ao iniciar a depuração.

O agente parte de consultas amplas para uma inspeção granular de dados.

  1. Executar consulta de teste

    O agente realiza uma busca para verificar o que o sistema atual retorna.

    rag_query

  2. Inspecionar resultados

    O agente analisa os segmentos de texto específicos que foram usados na resposta.

    search_chunks

  3. Verificar a origem

    O agente checa o grupo específico de documentos utilizado na busca.

    get_collection

  4. Comparar contexto

    O agente faz uma nova busca para ver se outros parâmetros trazem fragmentos melhores.

    rag_querysearch_chunks

Teste

Copie estes comandos para começar.

Use estes prompts para iniciar sua sessão de depuração.

Pontos de partida

Estes são exemplos iniciais. Substitua o texto entre colchetes pelos nomes reais das suas coleções ou termos de busca.

Cognita Connector

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

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

  • Execute uma rag_query para 'relatórios de vendas recentes' e mostre os chunks usados.

  • Busque na coleção 'customer_feedback' por chunks relacionados a 'latência'.

  • Obtenha os detalhes da coleção 'product_manual' e verifique seu tamanho.

  • Encontre os chunks específicos na coleção 'legal_docs' que mencionam 'responsabilidade civil'.

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

Comece aqui

Conecte o Cognita uma vez e pronto.

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

Conectar o Cognita à sua IA

FAQ

Como funciona esta tarefa.

  • 01

    A IA pode alterar meus fragmentos de documentos?

    Não. A IA só pode ler e inspecionar os dados. Você deve editar seus documentos ou reindexá-los manualmente.

  • 02

    A IA pode excluir uma coleção?

    Não. Não existem ferramentas fornecidas para excluir ou modificar suas coleções de dados.

  • 03

    Isso funciona com qualquer banco de dados vetorial?

    Funciona com qualquer dado gerenciado através do framework Cognita.

  • 04

    A IA pode corrigir uma recuperação ruim automaticamente?

    Não. A IA identifica o problema, mas cabe a você decidir como corrigir a indexação ou os prompts.

  • 05

    Como vejo o texto bruto de um fragmento?

    Você pode pedir ao agente para buscar chunks específicos para visualizar o texto exato que ele recuperou.

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

Conecte Cognita ao Claude, Cursor, ChatGPT e outros