> 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/nlp/natural-language-processing-nlp/using-context.md).

# Contexto

<figure><img src="/files/473587bdc9eb8afc8094ee2d037c797a99f16cad" alt=""><figcaption></figcaption></figure>

O contexto possibilita reutilizar o mesmo intent em vários blocos, um recurso importante na criação de bots!

<details>

<summary>Exemplo</summary>

Vamos aprender a usar contexto com este breve exemplo:

Então, criamos um bot que pode ajudar os usuários a fazer um pedido de comida. Em um momento da conversa, o bot perguntará ao usuário se ele gostaria de uma sobremesa grátis. O usuário pode responder com 'sim' ou 'não'. Um pouco mais tarde na conversa, o bot perguntará ao usuário se ele está pronto para fazer o pedido. Novamente, o usuário pode responder com 'sim' ou 'não'.

Precisamos de contexto para que o 'sim' ou 'não' levem a fluxos diferentes dependendo de onde forem ditos na conversa.

</details>

## Adicione contexto ao seu fluxo

Para usar contexto em um intent:

1. Certifique-se de que você [criou intents](/chatlayer-documentation-pt-br/navegacao/natural-language-processing-nlp/intents.md#add-a-new-intent) e os vinculou a [blocos](/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state.md). Neste exemplo, vamos usar **general\_yes** e **general\_no** intents.

<figure><img src="/files/da5aaac7ddbe7eb1a20133e942fcb3b321e74143" alt=""><figcaption><p>Dois blocos, um para cada possível resposta do usuário</p></figcaption></figure>

2. Abra o bloco que contém a pergunta.
3. Vá para a **PLN** seção.
4. Em **Definir contexto de saída e tempo de vida**, crie um **contexto de saída.** Neste exemplo, vamos chamá-lo de **book\_ticket** com um **tempo de vida** de &#x31;**.**

{% hint style="info" %}
O **tempo de vida** indica quantas vezes um contexto pode ser definido ao longo de toda a conversa. Por exemplo: Se o bot oferecer sobremesa grátis duas vezes em uma conversa, devemos colocar o **tempo de vida** em 2, porque o usuário pode dizer *sim* ou *não* duas vezes para esta pergunta. Neste exemplo, ofereceremos sobremesa grátis apenas uma vez, então manteremos o **tempo de vida** em 1.
{% endhint %}

<figure><img src="/files/988e281fc307547a389245a37a9919825b8f4385" alt=""><figcaption><p>Adicione um contexto de saída e um tempo de vida a um bloco.</p></figcaption></figure>

5. Clique em **Salvar**.
6. Abra o seu [bloco de intent](/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state.md#intent). Por exemplo, abra o **general\_yes** bloco de intent.
7. Navegue até a **PLN** aba.
8. Em **Contexto obrigatório**, procure o contexto que você acabou de criar. Neste exemplo, será **book\_ticket**.

<figure><img src="/files/f22d64becdb783b76496a343860301b48dc32478" alt=""><figcaption><p>Adicione um contexto obrigatório a um bloco de intent.</p></figcaption></figure>

9. Clique em **Salvar**.

<details>

<summary>Dicas para visualizar o contexto na tela do canvas</summary>

No canvas do seu bot [canvas](/chatlayer-documentation-pt-br/navegacao/bot-builder/flows.md), visualizar o contexto à primeira vista pode não ser tão simples.

* **Passe o mouse para ver o contexto**

Ao passar o mouse sobre o contexto de entrada ao lado do título do intent, você pode visualizar instantaneamente o contexto obrigatório que acabou de configurar. Isso oferece uma visão clara dos requisitos de contexto do seu intent, permitindo que você faça os ajustes necessários.

<img src="/files/897de62e7bc113eb4b011c6c526e6826f6b85444" alt="" data-size="original">

* **Use conexões pai**

Para melhorar a visualização, você pode definir o **Faça uma pergunta** bloco como um [pai](/chatlayer-documentation-pt-br/navegacao/bot-builder/flows/canvas-functionalities.md#parent-child-connections) ao bloco de intent. Isso cria uma conexão visual clara que melhora a legibilidade.

<img src="/files/b1025b307fb4584fdd3edf931f123ea43a2fb441" alt="" data-size="original">

</details>

10. Siga o mesmo processo para outros pontos da conversa em que esses intents são usados. Assim, você pode ter certeza de que o bot fornecerá a resposta certa!

<figure><img src="/files/29496be647d61aaf9b1db34fa8c462c09505bc76" alt=""><figcaption><p>Use os mesmos intents em diferentes pontos da conversa usando contexto.</p></figcaption></figure>

{% hint style="warning" %}
Um usuário pode ter vários contextos ao navegar entre diferentes fluxos de conversa. Quando são encontradas várias combinações de intents e contexto de entrada, é considerado o contexto do usuário com o maior valor de tempo de vida.
{% endhint %}


---

# 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/nlp/natural-language-processing-nlp/using-context.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.
