Fuentes de conocimiento

Las fuentes de conocimiento son la forma en que los agentes buscan y recuperan datos del catálogo como contexto del agente. Ayudan a los agentes a interpretar el contenido del catálogo y devolver las filas y los campos correctos para cumplir tus objetivos. Los agentes de catálogo también reciben datos de filas del campo de catálogo en el que están desplegados; las fuentes de conocimiento añaden contexto de catálogo con capacidad de búsqueda en + Agent context. Para una introducción a Braze Agents, consulta Braze Agents. Para añadir una fuente de conocimiento a un agente, consulta Crear agentes personalizados.

Cómo funciona

Una fuente de conocimiento es una vista seleccionada de un catálogo que agregas como + Agent context. Cuando adjuntas la fuente de conocimiento a un agente, incluyes solo los campos que respaldan tu caso de uso. Cuando un agente necesita información del catálogo, consulta la fuente de conocimiento para recuperar las filas coincidentes. Braze devuelve solo los datos relevantes del catálogo, no el catálogo completo, para que el agente pueda trabajar con un contexto preciso y enfocado.

Supongamos que estás creando un agente para recomendar restaurantes en la ciudad de Nueva York basándose en la cocina favorita de un usuario, que es un atributo personalizado. Este agente hace referencia a la fuente de conocimiento del catálogo “nyc_restaurants”. Cuando adjuntas esa fuente de conocimiento al agente, incluyes solo los campos que el agente necesita, como el nombre del restaurante, la ubicación y el tipo de cocina, y excluyes otras columnas del catálogo que no son útiles para las recomendaciones.

Las instrucciones del agente describen claramente su rol y sus restricciones:

1

You are a restaurant recommendation agent. Use your knowledge to help find restaurants for the user. Only include filters in your knowledge source query. Don't ask any followup questions. The user's favorite cuisine is {{custom_attribute.${favorite_cuisine}}}

Si la cocina favorita de un usuario es pizza, el agente puede devolver la siguiente respuesta basándose en la fuente de conocimiento:

1
2
3

Here are some pizza recommendations for you:
- Dale's Pizza (Greenwich Village, Manhattan): Dale's Pizza invites you to savor the taste of authentic New York. Nestled in the heart of Manhattan, this iconic pizzeria offers a warm and inviting atmosphere perfect for any occasion.
- Pizza Palace (Carroll Gardens, Brooklyn): Pizza Palace is a highly-rated culinary gem renowned for its exquisite pizza. This inviting spot offers a warm and modern dining experience.

Crear una fuente de conocimiento

Para crear una fuente de conocimiento:

1. Ve a Agent Console > Knowledge Sources.
2. Selecciona Add knowledge source. En el menú desplegable, selecciona Catalog.
3. Selecciona el catálogo en el menú desplegable.
4. (opcional) Añade una descripción para describir lo que contiene la fuente de conocimiento.
5. Selecciona Create knowledge source.

También puedes crear una fuente de conocimiento mientras estás construyendo un agente yendo a la sección Instructions de tu agente. Selecciona Add knowledge > Create knowledge source.

Usar una fuente de conocimiento en tu agente de IA

Puedes gestionar las fuentes de conocimiento desde la sección Knowledge Sources. Aquí puedes ver detalles como qué fuentes de conocimiento están activas y cuándo se sincronizaron por última vez. Ten en cuenta que el nombre de la fuente de conocimiento coincide con el nombre del catálogo utilizado como fuente.

Para usar una fuente de conocimiento en tu agente de IA:

1. Ve a la sección Instructions de tu agente.
2. Selecciona + Agent context > Add knowledge.
3. En el menú desplegable, selecciona la fuente de conocimiento.
4. Selecciona Configure fields para la fuente de conocimiento y, a continuación, desmarca los campos del catálogo que el agente no debería usar al buscar.

Incluir todos los campos del catálogo puede añadir contexto innecesario y reducir la calidad de los resultados. Desmarcar los campos que no son relevantes para tu caso de uso ayuda al agente a centrarse en los datos que importan.

Ahora, tu agente puede consultar la fuente de conocimiento y recuperar los datos relevantes del catálogo.

Para agentes conversacionales, añade una fuente de conocimiento como herramienta en un paso del flujo de trabajo en lugar de + Agent context. Consulta Buscar fuentes de conocimiento.

Preguntas frecuentes

¿Cómo funcionan las fuentes de conocimiento?

Convertir un catálogo en una fuente de conocimiento ayuda a Braze Agents a comprender el verdadero significado detrás de las palabras y frases del catálogo, de modo que los agentes puedan encontrar datos significativos de manera más eficaz para generar mejores resultados.

¿Cuándo debo crear una fuente de conocimiento?

Crea una fuente de conocimiento cuando un agente necesite buscar o recuperar datos de un catálogo; por ejemplo, para consultar destinos, productos o restaurantes durante un recorrido de Canvas, o para responder preguntas sobre productos y preguntas frecuentes en un flujo de trabajo conversacional. Las fuentes de conocimiento son la forma admitida de agregar ese contexto de catálogo con capacidad de búsqueda. Los agentes de catálogo que solo enriquecen la fila en la que están desplegados pueden no necesitar una fuente de conocimiento a menos que deban hacer referencia a datos adicionales del catálogo en tiempo de ejecución.

¿Puedo seguir adjuntando un catálogo directamente como contexto del agente?

No. Los nuevos agentes usan fuentes de conocimiento en lugar de la opción heredada Add catalog fields. Si un agente existente fue configurado con la opción heredada Add catalog fields, puedes seguir usándola mientras migras a una fuente de conocimiento equivalente.

Si un agente tiene una fuente de conocimiento como contexto, ¿también necesito asignar el catálogo original como contexto?

No. La fuente de conocimiento es la referencia de catálogo para el agente; no necesitas adjuntar ambos. Cuando adjuntes la fuente de conocimiento al agente, incluye solo los campos del catálogo que tu agente necesite.

¿Cómo debo evaluar la efectividad de una fuente de conocimiento?

Duplica cualquier agente existente que aún adjunte un catálogo directamente como contexto y cámbialo para que use la fuente de conocimiento equivalente en su lugar. Ejecuta algunas invocaciones de prueba en Agent Console para verificar la precisión y luego considera reemplazar el agente existente donde esté desplegado, o realizar pruebas A/B del agente anterior contra el nuevo agente (usando el paso de recorrido de experimentos) para comprender el impacto en el rendimiento.