> 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/detect-information-with-entities/composite-entities.md).

# Entidades compostas

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

<figure><img src="/files/e36afc9027f004322ed567d4c3f8d429f223ba76" alt=""><figcaption><p>Aba 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:

* `@sys.number` **:** *2*, uma [entidade de sistema](/chatlayer-documentation-pt-br/nlp/natural-language-processing-nlp/detect-information-with-entities/system-entities.md).
* e `@foodItem`: *batatas fritas*, uma [entidade de correspondência](/chatlayer-documentation-pt-br/nlp/natural-language-processing-nlp/detect-information-with-entities/match-entities.md).

</details>

### Adicionar uma entidade composta

Para adicionar uma entidade composta ao seu bot:

1. Do seu [**Entidades**](/chatlayer-documentation-pt-br/navegacao/natural-language-processing-nlp/synonym-entities.md) guia, certifique-se de ter entidades diferentes das quais sua entidade composta será formada. Neste exemplo, criamos uma `@car_brand` entidade de correspondência e usaremos `@sys.number`.
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="/files/e0127227cd3e1ae6abf8fb56eb7a71ffa70f7303" alt="" width="375"><figcaption><p>Adicione 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**](/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/user-input-bot-dialog.md) bloco em que sua entidade composta será detectada. Neste exemplo, detectamos `@car_info`.

<figure><img src="/files/beeced5411765e73dd732ff18b30e4b5d7d76ad7" 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:
   * Quando o ano for igual ou superior a 2016, o carro é um carro verde
   * Quando o ano for menor que 2016, o carro não é um carro verde.
3. Crie um [**Condição**](/chatlayer-documentation-pt-br/buildabot/flow-logic/dialog-state/plugins.md) bloco que verifica o `@car_brand.sys.number` variável.

<figure><img src="/files/222c5ab0608c39cb7dd4b2a36d0a47c3fb4a7113" alt="" width="375"><figcaption><p>Roteie o fluxo com base em parte de uma entidade composta.</p></figcaption></figure>

4. Clique em **Salvar**.


---

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