> For the complete documentation index, see [llms.txt](https://docs.chatlayer.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/navegacao/knowledge-base-ai/build-your-kbai-flow.md).

# Construa seu fluxo de KBAI

Assim que você [adicionou conteúdo ao seu KBAI](/chatlayer-documentation-pt-br/navegacao/knowledge-base-ai/add-content-to-your-kbai.md), chegou a hora de criar um fluxo em que seu bot saberá quando consultar esta base de conhecimento para fornecer uma resposta à pergunta do seu cliente.

Para criar seu fluxo de KBAI, você pode:

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Usar o bot de modelo de KBAI</strong></td><td>Criar seu fluxo de KBAI com um bot pronto.</td><td></td><td><a href="/files/cbe089d7e05677f396b5cfede614d345ae963020">/files/cbe089d7e05677f396b5cfede614d345ae963020</a></td><td><a href="/pages/bc6f1799960416da15ee2244c23a57ddfd61c723#knowledge-base-ai">/pages/bc6f1799960416da15ee2244c23a57ddfd61c723#knowledge-base-ai</a></td></tr><tr><td><strong>Criar seu próprio fluxo de KBAI</strong></td><td>Um guia passo a passo de como criar seu fluxo de FAQ usando KBAI.</td><td></td><td><a href="/files/56c55d94a733ffbf8434f6c08bdfe056747e1baa">/files/56c55d94a733ffbf8434f6c08bdfe056747e1baa</a></td><td><a href="#build-a-knowledge-base-flow">#build-a-knowledge-base-flow</a></td></tr><tr><td></td><td></td><td></td><td></td><td></td></tr></tbody></table>

## Recuperar a resposta do KBAI

Para recuperar uma resposta da base de conhecimento:

1. Adicione um [**Ação**](/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/action-bot-dialog.md) bloco na sua tela. Para este exemplo, vamos nomear este bloco "Gerar resposta".

{% hint style="warning" %}
Muitos clientes preferem que o fluxo da base de conhecimento aconteça depois que o bot não entendeu o que foi perguntado, como uma opção de fallback. Para fazer isso, vá até o seu **Não Entendido** bloco, altere o tipo dele para **Ação**, e continue seguindo os passos abaixo.
{% endhint %}

2. Clique em **IA da base de conhecimento.**

<figure><img src="/files/202cf8b1d12c443e4d7adec399ffa5b35e8530d4" alt="" width="375"><figcaption><p>Adicione um bloco de Ação da base de conhecimento para gerar uma resposta.</p></figcaption></figure>

3. Preencha os campos adequadamente. Você pode configurar:
   * **Variável de destino**: a resposta da base de conhecimento será armazenada como uma [variável](/chatlayer-documentation-pt-br/navegacao/settings/secure-variables-gdpr.md). No primeiro campo, você pode escolher o nome dessa variável.
   * **Se não houver resultados:** se a pergunta feita pelo usuário não puder ser respondida pela IA da base de conhecimento, um bloco será acionado. Você pode selecionar qual bloco neste menu suspenso.
   * **Em caso de falha**: se houver um problema com a IA da base de conhecimento e ela retornar um erro, você pode selecionar um bloco para o qual o usuário será encaminhado. Por padrão, os usuários serão direcionados para o **Ocorreu um erro** bloco.

<figure><img src="/files/3737c1af03acc3d5f4035884d99d6814f7942d24" alt=""><figcaption><p>Configure como seu bot recupera uma resposta com KBAI.</p></figcaption></figure>

3. **Salvar** suas alterações.

Seu bot agora pode consultar o KBAI e recuperar uma resposta com base nele. Mas ainda não consegue exibir essa resposta. Vamos ver como fazer isso na seção abaixo.

## Exibir a resposta do KBAI

Para exibir a resposta da base de conhecimento:

1. Abra a **Ação** bloco que você acabou de criar.
2. Na parte inferior do bloco, adicione um **Go-to** para um bloco que você pode criar no menu suspenso. Neste exemplo, chamaremos este bloco de *Resultado KB*.

<figure><img src="/files/5380cb1a25fc08785feb995b74b73cbb723c365f" alt=""><figcaption><p>Adicione um bloco que exiba a resposta gerada.</p></figcaption></figure>

4. **Salvar** suas alterações.
5. Abra o bloco "Resultado KB" recém-criado.
6. Adicione um **Mensagem de texto** que contém a variável que você escolheu para salvar a resposta da IA da base de conhecimento. Por padrão, esta é `{knowledgebase.answer}.`

<figure><img src="/files/a474ac5e848dc5a9951564733df235a3debaeec1" alt=""><figcaption></figcaption></figure>

4. **Salvar** suas alterações.

### Encaminhe seu fluxo de KBAI

Há várias maneiras de encaminhar seu fluxo de KBAI.

Você pode encaminhar seu fluxo de KBAI com base nos [dados da sessão](#kbai-session-data) dentro do `knowledgebase` objeto.

<details>

<summary>Dados da sessão do KBAI</summary>

Você pode acessar os dados da sua sessão de KBAI usando a [**Depurador**](/chatlayer-documentation-pt-br/buildabot/emulator.md#debugger) aba dentro do Emulator.

A `knowledgebase` objeto contém vários campos:

* `answer`: a resposta que pode ser usada em uma mensagem de texto no seu bot
* `retrieved`: uma matriz de todo o conteúdo que foi usado para formular a resposta. Para cada item do array, os seguintes dados são armazenados:
  * `tipo`: tipo da fonte: "URL" ou "DOC"
  * `nome`: nome do arquivo do documento ou link da URL
  * `content`: trecho do conteúdo que foi usado para gerar a resposta
  * `tags`: quaisquer [tags](/chatlayer-documentation-pt-br/navegacao/knowledge-base-ai/use-tags-to-limit-your-kbai-content.md) que foram recuperados e associados à fonte do conteúdo.
  * `contentType`: tipo da fonte: "URL" ou "DOC"
* `contentUrl`: URL da fonte que foi usada. Se um domínio tiver sido raspado como conteúdo, essa URL fará referência à página específica da qual a resposta foi recuperada.

</details>

Você também pode querer usar tags no seu conteúdo para especificar qual conteúdo o bot deve consultar.

{% content-ref url="/pages/bbc4c7d273e12ff625e7093335c4eb6e7284d14e" %}
[Use tags para limitar o conteúdo da sua KBAI](/chatlayer-documentation-pt-br/navegacao/knowledge-base-ai/use-tags-to-limit-your-kbai-content.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.chatlayer.ai/chatlayer-documentation-pt-br/navegacao/knowledge-base-ai/build-your-kbai-flow.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.