Fontes de conhecimento
As fontes de conhecimento permitem que os agentes pesquisem e recuperem dados do catálogo como contexto. Elas ajudam os agentes a interpretar o conteúdo do catálogo e a retornar as linhas e os campos certos para atingir seus objetivos. Os agentes de catálogo também recebem dados de linha do campo de catálogo em que estão implantados. Já 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 + Contexto do agente. Ao anexar a fonte de conhecimento a um agente, você inclui apenas os campos que atendem ao 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, e não o catálogo completo. Assim, o agente trabalha 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 do usuário, que é um atributo personalizado. Esse agente usa a fonte de conhecimento do catálogo “nyc_restaurants”. Ao anexar essa fonte de conhecimento ao agente, você inclui apenas os campos de que o agente precisa, como nome do restaurante, local e culinária, e exclui as outras colunas do catálogo que não ajudam nas recomendações.
As instruções do agente descrevem claramente sua função e suas restrições:
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:
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:
- Acesse Agentes > Fontes de conhecimento.
- Selecione Adicionar fonte de conhecimento. No menu suspenso, selecione Catálogo.
- Selecione o catálogo no menu suspenso.
- (opcional) Adicione uma descrição para explicar o que a fonte de conhecimento contém.
- Selecione Criar fonte de conhecimento.
Você também pode criar uma fonte de conhecimento enquanto cria um agente. Para isso, acesse a seção Instruções do seu agente e selecione Adicionar conhecimento > Criar fonte de conhecimento.
Usar uma fonte de conhecimento no seu agente de IA
Você pode gerenciar as fontes de conhecimento na seção Fontes de conhecimento. Lá, você vê detalhes como quais fontes de conhecimento estão ativas e quando foram sincronizadas pela última vez. O nome da fonte de conhecimento é o mesmo do catálogo usado como fonte.
Para usar uma fonte de conhecimento no seu agente de IA:
- Acesse a seção Instruções do seu agente.
- Selecione + Contexto do agente > Adicionar conhecimento.
- No menu suspenso, selecione a fonte de conhecimento.
- Selecione Configurar campos para a fonte de conhecimento e desmarque os campos do catálogo que o agente não deve usar nas buscas.
Incluir todos os campos do catálogo pode adicionar contexto desnecessário e reduzir a qualidade das respostas. Quando você desmarca os campos que não são relevantes para o seu caso de uso, o agente consegue focar nos dados que realmente importam.
Pronto! 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 do fluxo de trabalho, em vez de usar + Contexto do agente. Confira Pesquisar fontes de conhecimento.
Perguntas frequentes
Como funcionam as fontes de conhecimento?
Converter um catálogo em uma fonte de conhecimento ajuda os Braze Agents a entender o real significado das palavras e frases do catálogo. Assim, os agentes conseguem encontrar dados relevantes com mais eficiência e gerar resultados melhores.
Quando devo criar uma fonte de conhecimento?
Crie uma fonte de conhecimento quando um agente precisar pesquisar ou recuperar dados do catálogo. Por exemplo, para consultar destinos, produtos ou restaurantes durante uma jornada no Canvas, ou para responder a perguntas sobre produtos e dúvidas frequentes em um fluxo de trabalho conversacional. As fontes de conhecimento são a forma compatível de adicionar esse contexto de catálogo pesquisável. Os agentes de catálogo que apenas enriquecem a linha em que estão implementados podem não precisar de uma fonte de conhecimento, a menos que precisem consultar dados adicionais do catálogo em tempo de execução.
Ainda posso anexar um catálogo diretamente como contexto do agente?
Não. Os novos agentes usam fontes de conhecimento em vez da opção legada Adicionar campos de catálogo. Se um agente existente foi configurado com a opção legada Adicionar campos de catálogo, você pode continuar usando essa configuraçã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 já é a referência de catálogo do agente, então você não precisa anexar os dois. Ao 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 altere-o para usar a fonte de conhecimento equivalente. Execute algumas invocações de teste no Agent Console para garantir a precisão. Depois, considere substituir o agente existente onde ele estiver implementado ou fazer um teste A/B entre o agente antigo e o novo (usando a etapa de jornada experimental) para entender o impacto no desempenho.