Fontes de conhecimento

As fontes de conhecimento ajudam seus agentes de IA a interpretar dados do catálogo e recuperar as informações certas para atingir seus objetivos. Para uma introdução aos Braze Agents, consulte Braze Agents. Para adicionar conhecimento a um agente, consulte Criar agentes personalizados.

Como funciona

As fontes de conhecimento são um tipo de contexto de agente. Um agente de IA pode consultar uma fonte de conhecimento para recuperar dados do catálogo com mais precisão do que se o catálogo fosse referenciado diretamente nas instruções do agente.

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 faz referência à fonte de conhecimento do catálogo “nyc_restaurants”. Ao criar essa fonte de conhecimento, você inclui apenas os campos que o agente precisa — como nome do restaurante, local e tipo de culinária — e exclui outras colunas do catálogo que não contribuem para as 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. Revise os campos do catálogo e desmarque os que não se aplicam ao caso de uso do seu agente. Recomendamos excluir campos do catálogo que não são úteis para recuperação ou geração — limite a fonte de conhecimento apenas aos campos de que seu agente precisa.
5. (opcional) Adicione uma descrição para descrever o que a fonte de conhecimento contém.
6. Selecione Add Knowledge Source.

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

Você também pode criar uma fonte de conhecimento enquanto constrói 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. Note que 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.

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

Perguntas frequentes

Como as fontes de conhecimento funcionam?

Converter um catálogo em uma fonte de conhecimento ajuda os Braze Agents a entender 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 estiver configurando um agente personalizado (Canvas Step Agent ou Catalog Agent) que precisa de dados do catálogo como contexto. As fontes de conhecimento ajudam os agentes a recuperar dados do catálogo com mais precisão do que referenciar o catálogo diretamente nas instruções do agente.

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 substitui o catálogo como contexto do agente — você não precisa anexar ambos. Ao criar a fonte de conhecimento, inclua apenas os campos do catálogo que seu agente precisa.

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

Duplique qualquer agente existente que referencia um catálogo regular e altere-o para referenciar 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á sendo implantado ou fazer testes A/B do agente antigo contra o novo agente (usando a etapa de jornada experimental) para entender o impacto na performance.