Skip to content

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 de que o agente precisa — como nome do restaurante, localização 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 Console do agente > Fontes de conhecimento.
  2. Selecione Adicionar fonte de conhecimento. No menu suspenso, selecione Catálogo.
  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 sejam úteis para recuperação ou geração — limite a fonte de conhecimento apenas aos campos de que o agente precisa.
  5. (opcional) Adicione uma descrição para descrever o conteúdo da fonte de conhecimento.
  6. Selecione Adicionar fonte de conhecimento.

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.

Uma fonte de conhecimento "nyc_restaurants" que faz referência ao catálogo "nyc_restaurants".

Você também pode criar uma fonte de conhecimento enquanto constrói um agente, acessando a seção Instruções do seu agente. Selecione Adicionar conhecimento > Criar fonte de conhecimento.

Usar uma fonte de conhecimento no seu agente de IA

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

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

  1. Acesse a seção Instruções do seu agente.
  2. Selecione + Contexto do agente > Adicionar conhecimento.
  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 (agente Canvas ou agente de catálogo) 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 de que o agente precisa.

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

Duplique qualquer agente existente que faça referência a um catálogo comum e altere-o para referenciar a fonte de conhecimento equivalente. Execute algumas invocações de teste no Console do agente para garantir a precisão e, em seguida, considere substituir o agente existente onde ele está implantado ou fazer testes A/B entre o agente antigo e o novo (usando a etapa de jornada experimental) para entender o impacto no desempenho.
New Stuff!