# Construa seu fluxo KBAI

Uma vez que você [adicionou conteúdo ao seu KBAI](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/navegacao/knowledge-base-ai/add-content-to-your-kbai), é hora de construir um fluxo onde seu bot saberá quando consultar essa base de conhecimento para fornecer uma resposta à pergunta do seu cliente. 

Para criar seu fluxo 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 modelo KBAI</strong></td><td>Fazer seu fluxo KBAI com um bot pronto.</td><td></td><td><a href="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FfiiE5haHAEsXAwCnnngD%2FScreenshot%202024-08-20%20at%2011.42.47.png?alt=media&#x26;token=fdaf386d-847d-4642-bb20-639529c86a6a">Screenshot 2024-08-20 at 11.42.47.png</a></td><td><a href="../../../comece-rapidamente/bot-templates#knowledge-base-ai">#knowledge-base-ai</a></td></tr><tr><td><strong>Construir seu próprio fluxo KBAI</strong></td><td>Um guia passo a passo sobre como fazer seu fluxo de FAQ usando KBAI.</td><td></td><td><a href="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FxaKq6gk58YB79Xs1p9x7%2FScreenshot%202024-08-20%20at%2011.50.58.png?alt=media&#x26;token=26ea8f31-952a-46d3-bb1c-9c22fcb331b5">Screenshot 2024-08-20 at 11.50.58.png</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. Solte um [**Ação**](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/action-bot-dialog) bloco em sua tela. Para este exemplo, vamos nomear este bloco "Gerar resposta".

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

2. Clique em **Inteligência Artificial da base de conhecimento.**

<figure><img src="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FpNy6O1AUTZxbUbXN32im%2FScreenshot%202024-08-20%20at%2014.16.16.png?alt=media&#x26;token=66528308-3e18-4338-b668-2b5aec75a397" 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](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/navegacao/settings/secure-variables-gdpr). No primeiro campo, você pode escolher o nome dessa variável.
   * **Em caso de nenhuma descoberta:** se a pergunta que o usuário faz 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á direcionado. Por padrão, os usuários serão encaminhados para o **Ocorreu um Erro** bloco.

<figure><img src="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FuNYtYLeuemHlekxdHArH%2Fimage.png?alt=media&#x26;token=89c81fea-8210-4c47-b2b4-9233ca905a43" alt=""><figcaption><p>Configure como seu bot recupera uma resposta com o KBAI.</p></figcaption></figure>

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

Seu bot agora pode vasculhar o KBAI e recuperar uma resposta com base nele. Mas ele ainda não pode 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 **Conexões Ir para** para um bloco que você pode criar a partir do menu suspenso. Neste exemplo, chamaremos este bloco de *Resultado KB*.

<figure><img src="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2Fky0Q3LHLCNdQ2pa2eSY8%2Fimage.png?alt=media&#x26;token=ecaabb39-f9d3-4374-a452-9a8049ecc36b" alt=""><figcaption><p>Adicione um bloco que exiba a resposta gerada.</p></figcaption></figure>

4. **Salvar** suas alterações.
5. Abra o bloco recém-criado "Resultado KB".
6. Adicionar 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, isto é `{knowledgebase.answer}.`

<figure><img src="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2Fz8V5mksVw1GN6Z9Kv8Tp%2Fimage.png?alt=media&#x26;token=8e2615b0-7300-437a-81ba-30130929c901" alt=""><figcaption></figcaption></figure>

4. **Salvar** suas alterações.&#x20;

### Roteie seu fluxo KBAI

Existem várias maneiras de rotear seu fluxo KBAI.

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

<details>

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

Você pode acessar seus dados de sessão do KBAI usando a [**Depurador**](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/buildabot/emulator#debugger) aba dentro do Emulador.

O `knowledgebase` o objeto contém vários campos:

* `resposta`: a resposta que pode ser usada em uma mensagem de texto no seu bot
* `recuperado`: um array de todo o conteúdo que foi usado para formular a resposta. Para cada item do array, os seguintes dados são armazenados:
  * `type`: tipo da fonte: "URL" ou "DOC"
  * `nome`: nome do arquivo do documento ou link da URL
  * `conteúdo`: trecho do conteúdo que foi usado para gerar a resposta
  * `tags`: quaisquer [tags](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/navegacao/knowledge-base-ai/use-tags-to-limit-your-kbai-content) que foram recuperadas e que estão associadas à fonte de conteúdo.
  * `tipoDeConteúdo`: tipo da fonte: "URL" ou "DOC"
* `urlDoConteúdo`: URL da fonte que foi usada. Se um domínio foi rastreado como conteúdo, esta URL fará referência à página específica de onde a resposta foi recuperada.

</details>

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

{% content-ref url="use-tags-to-limit-your-kbai-content" %}
[use-tags-to-limit-your-kbai-content](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/navegacao/knowledge-base-ai/use-tags-to-limit-your-kbai-content)
{% endcontent-ref %}


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.