Retriever Tool
Retriever Tool convierte la búsqueda en una base de conocimiento, por ejemplo una base vectorial con tus documentos, en una herramienta para un agente. El agente la consulta cuando una pregunta necesita información de esos documentos y responde con lo que encuentra.
Conectas a Retriever el componente que busca en tus documentos, le das un nombre y una descripción, y conectas su salida Tool al conector Tools del agente.
Cuándo usarlo
- Tienes tus manuales o preguntas frecuentes en una base vectorial y quieres que un agente responda con ellos.
- Un agente tiene varias fuentes de información y quieres que elija la adecuada según la pregunta.
- Quieres que un asistente busque en tus documentos solo cuando haga falta, y no en cada mensaje.
- Combinas tus documentos internos con otras herramientas, como la búsqueda web.
Configuración
| Campo | Qué hace |
|---|---|
| Retriever (obligatorio) | El buscador de tu base de conocimiento. Conecta aquí la salida Retriever de una base vectorial, como Chroma DB. |
| Name (obligatorio) | El nombre con el que el agente ve la herramienta: palabras en minúscula unidas por _, por ejemplo manuales_producto. Por defecto, search_documents. |
| Description (obligatorio) | Lo que el agente lee para saber cuándo consultarla. Explica qué contiene, por ejemplo “Manuales de uso y mantenimiento de nuestros electrodomésticos”. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Prefix Prompt | Un texto que se añade delante de cada búsqueda del agente, para orientar los resultados. Por ejemplo, el nombre de la línea de producto. |
Resultado
Tool: la búsqueda lista para el agente. Conéctala al conector Tools del agente. Cada consulta devuelve los fragmentos de documentos más relacionados con la pregunta; si el buscador conectado no indica cuántos, se devuelven hasta 10.
Ejemplo
Una empresa de software quiere que su asistente de soporte responda con la documentación del producto.
- Conecta la salida Retriever de la base vectorial donde está la documentación a Retriever.
- En Name, escribe
documentacion_producto, y en Description, “Documentación oficial del producto: instalación, configuración y errores frecuentes”. - Conecta la salida Tool al conector Tools del agente.
- Cuando un cliente pregunta cómo exportar un informe, el agente consulta la documentación y responde con los pasos.
Buenas prácticas
- Una buena Description es lo que hace que el agente use la herramienta en el momento adecuado. Di qué tipo de preguntas resuelve.
- Si el agente tiene varias Retriever Tool, dale a cada una un nombre y una descripción que no se confundan.
Componentes relacionados
- SQLRetrieverTool: consultas a una base de datos como herramienta.
- Gemini File Search Store: base de conocimiento gestionada por Google Gemini.