• MATCHES
  • DOCUMENTS
  • MISSES
  • HUMAN

Cómo depurar la recuperación RAG con tu agente de IA

Conecta DataStax Astra DB Vector una sola vez. Después, tu agente podrá consultar tu base de datos para ver los datos exactos que alimentan tu prompt.

Pregunta a la IA sobre esta página

Respuesta rápida

¿Cómo puedo depurar la recuperación RAG con mi IA?

Puedes pedirle a tu agente que extraiga coincidencias vectoriales específicas o documentos JSON individuales de Astra DB. Esto te permite verificar si el contexto recuperado coincide realmente con tu consulta. Verás los datos exactos que se están utilizando.

Dónde aterrizan tus datos de depuración.

Resultados de tu inspección.

Tu agente utiliza estas herramientas para extraer evidencia de tu base de datos.

MATCHES

Verificar coincidencias vectoriales

La IA encuentra los vectores más cercanos a una consulta. Obtienes los fragmentos específicos que el flujo RAG está procesando actualmente.

DOCUMENTS

Inspeccionar JSON puro

Tu agente extrae los objetos JSON completos de registros específicos. Esto te ayuda a comprobar si los campos de metadatos o contenido tienen el formato correcto.

MISSES

Identificar fallos de recuperación

Al comparar lo que la IA encuentra con lo que esperabas, puedes detectar dónde está fallando tu modelo de embeddings o tu indexación.

HUMAN

Corregir el índice

La IA no puede reescribir tu base de datos ni cambiar tu lógica de embeddings. Deberás ajustar tus datos manualmente según lo que encuentre el agente.

El flujo

Lo que hace tu IA cuando llega la solicitud.

El agente actúa como un puente entre tu interfaz de chat y tu instancia de Astra DB.

  1. Buscar vectores similares

    Tu agente busca en el índice vectorial para encontrar la información más relevante para una consulta determinada.

    vector_search

  2. Extraer registros específicos

    Una vez identificado un documento relevante, el agente obtiene el registro completo para mostrarte todo el contexto.

    find_one_document

  3. Listar múltiples entradas

    El agente puede extraer un conjunto de documentos para ayudarte a comparar varias coincidencias potenciales a la vez.

    find_documents

  4. Analizar los resultados

    El agente revisa los datos recuperados y los compara con tu pregunta original para decirte si la recuperación fue exitosa.

    vector_searchfind_one_document

Pruébalo

Copia estos ejemplos para empezar.

Usa estos prompts para iniciar la depuración de tu recuperación.

Puntos de partida

Reemplaza el texto entre corchetes con tus nombres de colección o cadenas de consulta reales.

DataStax Astra DB Connector

Todo listo. Elige tu cliente MCP y sigue las instrucciones de configuración.

Enlace del conectorhttps://edge.vinkius.com/vk_preview_AqDRfth2dYqeDTcgeoWzkACu9uC1WOaTh5GDBWN7/mcp

Claude Desktop

Sigue los pasos siguientes para conectarte en 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.
Configuración · claude_desktop_config.jsonCopiar
{
  "mcpServers": {
    "datastax-astra-db-vector-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_AqDRfth2dYqeDTcgeoWzkACu9uC1WOaTh5GDBWN7/mcp"
    }
  }
}
Copia en el chat04

  • Ejecuta una búsqueda vectorial en la colección 'customer_support' con la consulta 'cómo restablezco mi contraseña' y muéstrame los resultados.

  • Busca el documento con ID 'user_12345' en Astra DB y dime si los metadatos contienen la región correcta.

  • Busca en la colección 'product_catalog' el término 'auriculares inalámbricos' y lista los 5 mejores documentos encontrados.

  • Revisa los resultados de la búsqueda vectorial para 'política de envíos' y dime si el texto recuperado realmente responde a la pregunta.

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

Empieza aquí

Conecta DataStax Astra DB Vector una vez y luego pregunta.

Solo tienes que proporcionar tus credenciales mediante la conexión segura. Una vez activa, tu agente podrá empezar a consultar tu base de datos de inmediato.

Conectar DataStax Astra DB Vector a tu IA

FAQ

Cómo funciona esta tarea.

  • 01

    ¿Puede la IA borrar datos de mi Astra DB?

    No. Las herramientas solo permiten a la IA buscar y encontrar documentos. No puede borrar ni modificar tus datos.

  • 02

    ¿Puede la IA actualizar mis embeddings vectoriales?

    No. La IA solo puede leer lo que ya está en la base de datos. Debes gestionar las actualizaciones de embeddings a través de tu propio flujo de trabajo.

  • 03

    ¿La IA tiene acceso a mis credenciales de base de datos?

    No. Tus credenciales están cifradas y gestionadas por Vinkius. Tu agente solo ve los datos que devuelven las herramientas.

  • 04

    ¿Puedo usar esto para mejorar la precisión de mi RAG?

    La IA puede mostrarte por qué la precisión es baja al revelarte qué se está recuperando, pero tú debes realizar las correcciones reales en tu código o en tus datos.

  • 05

    ¿Puede la IA realizar agregaciones complejas?

    No. La IA está limitada a las herramientas específicas de búsqueda y recuperación incluidas en el manifiesto.

  • ¿Tienes más dudas sobre DataStax Astra DB Vector? La página del conector tiene las respuestas. Ver todo lo que puede hacer el conector DataStax Astra DB Vector

Conecta DataStax Astra DB a Claude, Cursor, ChatGPT y más