# Entidades compostas

Uma entidade composta é uma combinação de duas ou mais entidades diferentes, porém relacionadas [entidades](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/nlp/natural-language-processing-nlp/detect-information-with-entities/..#entity-types). Esse tipo de entidade permite combinar duas entidades separadas em uma única.

<figure><img src="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2F4Ux34rQURegq9NTCTKvA%2FScreenshot%202024-08-23%20at%2012.24.20.png?alt=media&#x26;token=336e35f1-1fd5-42d3-a22e-96b81a6022ef" alt=""><figcaption><p>Guia de entidades compostas.</p></figcaption></figure>

<details>

<summary>Exemplo de entidade composta</summary>

Quando um usuário diz ao bot *Duas batatas fritas, por favor*, o bot entenderá isso como a entidade composta predefinida `@order`*,* que consiste em duas entidades separadas:&#x20;

* `@sys.number` **:** *2*, um [entidade do sistema](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/nlp/natural-language-processing-nlp/detect-information-with-entities/system-entities).
* e `@foodItem`: *batatas fritas*, um [entidade de correspondência](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/nlp/natural-language-processing-nlp/detect-information-with-entities/match-entities).&#x20;

</details>

### Adicionar uma entidade composta

Para adicionar uma entidade composta ao seu bot:

1. Do seu [**Entidades**](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/navegacao/natural-language-processing-nlp/synonym-entities) guia, certifique-se de que você tem diferentes entidades das quais sua composta será formada. Para este exemplo, criamos um `@car_brand` entidade de correspondência e usaremos `@sys.number`.&#x20;
2. Clique em **Entidade composta**s.
3. Clique em **Adicionar entidade composta**.
4. Preencha o **Nome da entidade**.
5. Em **Valores da entidade**, adicione as entidades que formarão a entidade composta.

<figure><img src="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FmtUk0VUKpBrs8sw74EjW%2FScreenshot%202024-08-23%20at%2012.25.24.png?alt=media&#x26;token=3c8d2f1e-0c62-45dd-93c4-f2d801a53496" alt="" width="375"><figcaption><p>Adicionar uma entidade composta.</p></figcaption></figure>

6. Clique em **Criar entidade**.

### Roteie sua conversa com base nos valores da entidade composta

Para rotear seu fluxo com base em entidades compostas:

1. Crie um [**Coletar entrada**](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/user-input-bot-dialog) bloco onde sua entidade composta será detectada. Neste exemplo, detectamos `@car_info`.

<figure><img src="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2Fa6GTfBYlpy3UoXBSEOgu%2FScreenshot%202024-08-23%20at%2012.30.19.png?alt=media&#x26;token=9696bd82-eb95-4517-8953-9edcc66814e5" alt="" width="375"><figcaption><p>Detecte uma entidade composta dentro do seu fluxo.</p></figcaption></figure>

2. Digamos que agora você queira rotear o fluxo com base no ano do carro. Por exemplo:&#x20;
   * Quando o ano é igual ou superior a 2016, o carro é um carro verde
   * Quando o ano é inferior a 2016, o carro não é um carro verde.
3. Crie um [**bloco de Condição**](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/plugins) bloco que verifica o `@car_brand.sys.number` variável.

<figure><img src="https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FIcH9cfTF1Pnw8eTcK2G6%2FScreenshot%202024-08-23%20at%2012.35.42.png?alt=media&#x26;token=faaeb6ab-e8f7-4ad2-8992-e97bdcc44f66" alt="" width="375"><figcaption><p>Roteie o fluxo com base em parte de uma entidade composta.</p></figcaption></figure>

4. Clique **Salvar**.


---

# 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/nlp/natural-language-processing-nlp/detect-information-with-entities/composite-entities.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.
