• MATCHES
  • DOCUMENTS
  • MISSES
  • HUMAN

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

Conecte o DataStax Astra DB Vector uma única vez. Depois disso, seu agente poderá acessar seu banco de dados para ver os dados exatos que alimentam seu prompt.

Pergunte à IA sobre esta página

Resposta rápida

Como posso depurar a recuperação RAG com minha IA?

Você pode pedir ao seu agente para buscar correspondências vetoriais específicas ou documentos JSON individuais no Astra DB. Isso permite verificar se o contexto recuperado realmente condiz com sua pergunta. Você verá exatamente quais dados estão sendo usados.

Onde os dados de depuração aparecem.

Os resultados da sua inspeção.

Seu agente utiliza estas ferramentas para extrair evidências do seu banco de dados.

MATCHES

Verificar acertos vetoriais

A IA encontra os vetores mais próximos de uma consulta. Você recebe os fragmentos específicos que o pipeline RAG está processando no momento.

DOCUMENTS

Inspecionar JSON bruto

Seu agente extrai os objetos JSON completos de registros específicos. Isso ajuda a conferir se os campos de metadados ou conteúdo estão formatados corretamente.

MISSES

Identificar falhas de recuperação

Ao comparar o que a IA encontra com o que você esperava, você identifica onde o modelo de embedding ou a indexação estão falhando.

HUMAN

Corrigir o índice

A IA não pode reescrever seu banco de dados ou alterar sua lógica de embedding. Você precisará ajustar seus dados manualmente com base no que o agente encontrar.

O fluxo

O que sua IA faz quando a tarefa chega.

O agente funciona como uma ponte entre sua interface de chat e sua instância do Astra DB.

  1. Buscar vetores similares

    Seu agente pesquisa o índice vetorial para encontrar as informações mais relevantes para uma determinada consulta.

    vector_search

  2. Extrair registros específicos

    Assim que um documento relevante é identificado, o agente busca o registro completo para mostrar todo o contexto.

    find_one_document

  3. Listar múltiplas entradas

    O agente pode extrair um conjunto de documentos para ajudar você a comparar várias correspondências potenciais de uma vez.

    find_documents

  4. Analisar os resultados

    O agente analisa os dados recuperados e os compara com sua pergunta original para dizer se a recuperação foi bem-sucedida.

    vector_searchfind_one_document

Teste

Copie estes comandos para começar.

Use estes prompts para iniciar a depuração da sua recuperação.

Pontos de partida

Substitua o texto entre colchetes pelos nomes reais das suas coleções ou termos de busca.

DataStax Astra DB Connector

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

Link do conectorhttps://edge.vinkius.com/vk_preview_AqDRfth2dYqeDTcgeoWzkACu9uC1WOaTh5GDBWN7/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 — DataStax Astra DB capabilities are ready to use.
Configuração · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "datastax-astra-db-vector-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_AqDRfth2dYqeDTcgeoWzkACu9uC1WOaTh5GDBWN7/mcp"
    }
  }
}
Copie no chat04

  • Execute uma busca vetorial na coleção 'customer_support' para a consulta 'como redefinir minha senha' e mostre os resultados.

  • Encontre o documento com ID 'user_12345' no Astra DB e me diga se os metadados contêm a região correta.

  • Busque na coleção 'product_catalog' por 'fones de ouvido sem fio' e liste os 5 principais documentos encontrados.

  • Verifique os resultados da busca vetorial para 'política de envio' e me diga se o texto recuperado realmente responde à pergunta.

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

Comece aqui

Conecte o DataStax Astra DB Vector uma vez e comece a perguntar.

Basta fornecer suas credenciais através da conexão segura. Assim que estiver ativo, seu agente poderá começar a consultar seu banco de dados imediatamente.

Conectar DataStax Astra DB Vector à sua IA

FAQ

Como esta tarefa funciona.

  • 01

    A IA pode deletar dados do meu Astra DB?

    Não. As ferramentas permitem apenas que a IA pesquise e encontre documentos. Ela não pode deletar ou modificar seus dados.

  • 02

    A IA pode atualizar meus embeddings vetoriais?

    Não. A IA só pode ler o que já está no banco de dados. Você deve gerenciar as atualizações de embedding através do seu próprio pipeline.

  • 03

    A IA tem acesso às minhas credenciais de banco de dados?

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

  • 04

    Posso usar isso para corrigir a precisão do meu RAG?

    A IA pode mostrar por que a precisão está baixa ao revelar o que está sendo recuperado, mas você deve realizar os ajustes reais no seu código ou nos seus dados.

  • 05

    A IA pode realizar agregações complexas?

    Não. A IA está limitada às ferramentas específicas de busca e recuperação fornecidas no manifesto.

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

Conecte DataStax Astra DB ao Claude, Cursor, ChatGPT e outros