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 a 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 en el que se puede buscar 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 añades como + Contexto del agente. Cuando vinculas 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 que coinciden. 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 en función de 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 vinculas 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 respaldan las recomendaciones.

Las instrucciones del agente describen con claridad su función y sus limitaciones:

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 la 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 Agentes > Fuentes de conocimiento.
2. Selecciona Añadir fuente de conocimiento. En el desplegable, selecciona Catálogo.
3. Selecciona el catálogo en el desplegable.
4. (opcional) Añade una descripción para indicar qué contiene la fuente de conocimiento.
5. Selecciona Crear fuente de conocimiento.

También puedes crear una fuente de conocimiento mientras creas un agente, desde la sección Instrucciones de tu agente. Selecciona Añadir conocimiento > Crear fuente de conocimiento.

Usar una fuente de conocimiento en tu agente de IA

Puedes administrar las fuentes de conocimiento desde la sección Fuentes de conocimiento. 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 que se usa como fuente.

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

1. Ve a la sección Instrucciones de tu agente.
2. Selecciona + Contexto del agente > Añadir conocimiento.
3. En el desplegable, selecciona la fuente de conocimiento.
4. Selecciona Configurar campos para la fuente de conocimiento y, a continuación, desmarca los campos del catálogo que el agente no deba usar al realizar búsquedas.

Incluir todos los campos del catálogo puede añadir contexto innecesario y reducir la calidad de la respuesta. 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 los agentes conversacionales, añade una fuente de conocimiento como herramienta en un paso del flujo de trabajo en lugar de usar + Contexto del agente. 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 entender el verdadero significado de las palabras y frases del catálogo, para que los agentes encuentren con mayor eficacia datos relevantes que generen mejores resultados.

¿Cuándo debo crear una fuente de conocimiento?

Crea una fuente de conocimiento cuando un agente necesite buscar o recuperar datos del 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 añadir ese contexto de catálogo en el que se puede buscar. Es posible que los agentes de catálogo que solo enriquecen la fila en la que están implementados no necesiten una fuente de conocimiento, a menos que deban consultar datos adicionales del catálogo en tiempo de ejecución.

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

No. Los agentes nuevos usan fuentes de conocimiento en lugar de la opción heredada Añadir campos del catálogo. Si un agente existente se configuró con la opción heredada Añadir campos del catálogo, puedes seguir usándolo mientras migras a una fuente de conocimiento equivalente.

Si a un agente se le ha asignado una fuente de conocimiento como contexto, ¿también tengo que asignar el catálogo original como contexto?

No. La fuente de conocimiento es la referencia del catálogo para el agente, así que 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 eficacia de una fuente de conocimiento?

Duplica cualquier agente existente que todavía adjunte un catálogo directamente como contexto y cámbialo para que use la fuente de conocimiento equivalente. Ejecuta algunas invocaciones de prueba en la Consola de agentes para comprobar la precisión y, después, plantéate sustituir el agente existente allí donde esté implementado, o hacer pruebas A/B del agente antiguo frente al nuevo (con un paso de recorrido de experimentos) para entender el impacto en el rendimiento.