Fontes de conhecimento

As fontes de conhecimento são a maneira como os agentes pesquisam e recuperam dados do catálogo como contexto do agente. Elas ajudam os agentes a interpretar o conteúdo do catálogo e retornar as linhas e campos corretos para atingir seus objetivos. Os agentes de catálogo também recebem dados de linha do campo de catálogo onde estão implantados; as fontes de conhecimento adicionam contexto de catálogo pesquisável em + Agent context. Para uma introdução aos Braze Agents, consulte Braze Agents. Para adicionar uma fonte de conhecimento a um agente, consulte Criar agentes personalizados.

Como funciona

Uma fonte de conhecimento é uma visualização curada de um catálogo que você adiciona como + Agent context. Quando você anexa a fonte de conhecimento a um agente, inclui apenas os campos que apoiam seu caso de uso. Quando um agente precisa de informações do catálogo, ele consulta a fonte de conhecimento para recuperar as linhas correspondentes. A Braze retorna apenas os dados relevantes do catálogo, não o catálogo completo, para que o agente possa trabalhar com um contexto focado e preciso.

Digamos que você esteja criando um agente para recomendar restaurantes em Nova York com base na culinária favorita de um usuário, que é um atributo personalizado. Esse agente referencia a fonte de conhecimento do catálogo “nyc_restaurants”. Quando você anexa essa fonte de conhecimento ao agente, inclui apenas os campos de que o agente precisa — como nome do restaurante, local e culinária — e exclui outras colunas do catálogo que não apoiam recomendações.

As instruções do agente descrevem claramente seu papel e suas restrições:

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}}}

Se a culinária favorita de um usuário for pizza, o agente pode retornar a seguinte resposta com base na fonte de conhecimento:

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.

Criar uma fonte de conhecimento

Para criar uma fonte de conhecimento:

1. Acesse Agent Console > Knowledge Sources.
2. Selecione Add knowledge source. No menu suspenso, selecione Catalog.
3. Selecione o catálogo no menu suspenso.
4. (opcional) Adicione uma descrição para descrever o que a fonte de conhecimento contém.
5. Selecione Create knowledge source.

Você também pode criar uma fonte de conhecimento enquanto estiver construindo um agente acessando a seção Instructions do seu agente. Selecione Add knowledge > Create knowledge source.

Usar uma fonte de conhecimento no seu agente de IA

Você pode gerenciar fontes de conhecimento na seção Knowledge Sources. Aqui, é possível ver detalhes como quais fontes de conhecimento estão ativas e quando foram sincronizadas pela última vez. Nota: o nome da fonte de conhecimento corresponde ao nome do catálogo usado como fonte.

Para usar uma fonte de conhecimento no seu agente de IA:

1. Acesse a seção Instructions do seu agente.
2. Selecione + Agent context > Add knowledge.
3. No menu suspenso, selecione a fonte de conhecimento.
4. Selecione Configure fields para a fonte de conhecimento e desmarque os campos do catálogo que o agente não deve usar ao pesquisar.

Incluir todos os campos do catálogo pode adicionar contexto desnecessário e reduzir a qualidade do resultado. Desmarcar campos que não são relevantes para o seu caso de uso ajuda o agente a focar nos dados que importam.

Agora, seu agente pode consultar a fonte de conhecimento e recuperar os dados relevantes do catálogo.

Para agentes conversacionais, adicione uma fonte de conhecimento como ferramenta em uma etapa de fluxo de trabalho em vez de + Agent context. Consulte Search knowledge sources.

Perguntas frequentes

Como as fontes de conhecimento funcionam?

Converter um catálogo em uma fonte de conhecimento ajuda os Braze Agents a entenderem o verdadeiro significado por trás das palavras e frases no catálogo, para que os agentes possam encontrar dados relevantes de forma mais eficaz e gerar melhores resultados.

Quando devo criar uma fonte de conhecimento?

Crie uma fonte de conhecimento quando um agente precisar pesquisar ou recuperar dados de catálogo — por exemplo, para buscar destinos, produtos ou restaurantes durante uma jornada no Canvas, ou para responder perguntas sobre produtos e perguntas frequentes em um fluxo conversacional. As fontes de conhecimento são a forma suportada de adicionar esse contexto pesquisável de catálogo. Agentes de catálogo que apenas enriquecem a linha em que estão implantados podem não precisar de uma fonte de conhecimento, a menos que precisem referenciar dados adicionais do catálogo em tempo de execução.

Ainda posso anexar um catálogo diretamente como contexto do agente?

Não. Novos agentes usam fontes de conhecimento em vez da opção legada Add catalog fields. Se um agente existente foi configurado com a opção legada Add catalog fields, você pode continuar usando-o enquanto migra para uma fonte de conhecimento equivalente.

Se um agente recebeu uma fonte de conhecimento como contexto, também preciso atribuir o catálogo original como contexto?

Não. A fonte de conhecimento é a referência de catálogo para o agente — você não precisa anexar ambos. Quando anexar a fonte de conhecimento ao agente, inclua apenas os campos do catálogo de que o agente precisa.

Como devo avaliar a eficácia de uma fonte de conhecimento?

Duplique qualquer agente existente que ainda anexe um catálogo diretamente como contexto e mude-o para usar a fonte de conhecimento equivalente. Execute algumas invocações de teste no Agent Console para garantir a precisão e, em seguida, considere substituir o agente existente onde ele está implantado ou realizar testes A/B entre o agente antigo e o novo (usando a etapa de jornada experimental) para entender o impacto na performance.