• MATCH
  • DRIFT
  • MISS
  • HUMAN

Como depurar similaridade vetorial com sua IA

Conecte o Couchbase ao seu cliente de IA para cruzar os resultados de busca com seus dados NoSQL brutos.

Pergunte à IA sobre esta página

Resposta rápida

Como posso verificar se meus resultados de busca vetorial são precisos?

Sua IA realiza uma busca de similaridade para encontrar os itens mais próximos e depois extrai o documento completo para conferir se o conteúdo faz sentido. Isso permite identificar onde seus embeddings estão se distanciando dos dados reais. Veja os resultados possíveis abaixo.

Resultados da depuração

Onde seus achados se encaixam.

A IA categoriza o que encontra durante o processo de verificação.

MATCH

Precisão verificada

A IA confirma que a correspondência vetorial está alinhada com o texto do documento. Você ganha confiança de que seus embeddings funcionam.

DRIFT

Divergência de embedding

A IA identifica quando uma alta pontuação de similaridade retorna um documento que não condiz com a consulta. Isso mostra onde seu modelo precisa de ajuste.

MISS

Falsos negativos

A IA encontra dados relevantes que a busca vetorial ignorou. Você verá onde sua estratégia de indexação ou embedding está falhando.

HUMAN

Revisão manual

A IA sinaliza documentos específicos que precisam da sua análise para decidir se o limite de similaridade está muito alto ou muito baixo.

O fluxo

O que sua IA faz quando a busca chega.

A IA utiliza ferramentas específicas para unir matemática e significado.

  1. Encontrar candidatos

    A IA identifica os documentos mais relevantes com base na representação vetorial da sua consulta.

    vector_search

  2. Buscar conteúdo

    A IA extrai o conteúdo JSON completo de cada candidato para inspecionar o texto e os metadados.

    get_document

  3. Comparar lógica

    A IA compara a intenção da consulta com os campos do documento recuperado para checar desvios semânticos.

    get_document

  4. Relatar achados

    A IA resume se os resultados da busca são de alta qualidade ou se os embeddings estão induzindo ao erro.

    vector_search

Teste

Copie estes exemplos para começar.

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

Pontos de partida

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

Couchbase Connector

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

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

  • Execute uma busca vetorial por 'bancos de dados de alta performance' e mostre os 3 principais documentos.

  • Compare os resultados da minha busca de similaridade por 'autenticação de usuário' com o conteúdo real dos documentos.

  • Encontre documentos relacionados a 'sistemas distribuídos' e me diga se o texto recuperado realmente condiz com a consulta.

  • Verifique por que o documento com ID 'user_123' está aparecendo nas minhas buscas de similaridade recentes.

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

Comece aqui

Conecte o Couchbase uma vez e comece a perguntar.

Basta fornecer seus dados de conexão. Suas credenciais ficam criptografadas e você pode começar a consultar seus dados imediatamente pelo seu cliente de IA.

Conectar Couchbase à sua IA

FAQ

Como funciona esta tarefa

  • 01

    A IA pode alterar meus dados no Couchbase?

    Não. A IA só pode ler dados usando as ferramentas disponíveis. Ela não pode atualizar, excluir ou inserir nenhum registro no seu banco de dados.

  • 02

    A IA pode criar novos índices vetoriais?

    Não. A IA só pode pesquisar índices já existentes. Você deve configurar seus índices vetoriais no Couchbase antes que a IA possa usá-los.

  • 03

    A IA vê todo o meu banco de dados?

    A IA só vê os dados que ela recupera por meio das ferramentas específicas fornecidas. Ela não tem uma visão geral de todo o seu cluster.

  • 04

    Como ela lida com documentos grandes?

    A IA usa a ferramenta de recuperação de documentos para extrair o conteúdo. Se um documento for muito grande, a IA processará o texto que receber para responder sua pergunta.

  • 05

    Posso usar isso com qualquer cliente de IA?

    Sim, desde que seu cliente suporte o Model Context Protocol (MCP).

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

Conecte Couchbase ao Claude, Cursor, ChatGPT e outros