Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
É possível criar entidades personalizadas para dados de correspondência específicos ao seu agente.
Por exemplo, defina um tipo de entidade vegetable que corresponda aos tipos de vegetais disponíveis para compra em um agente de mercearia.
Onde encontrar esses dados
Ao criar um agente,
o mais comum é usar o
console do Dialogflow ES. Acesse a documentação e abra o console (em inglês).
As instruções abaixo referem-se ao uso do Console.
Para acessar os dados da entidade personalizada:
Selecione Entities no menu da barra lateral à esquerda.
Selecione a guia Custom para entidades personalizadas.
Se você estiver usando a API em vez do Console para criar um agente, consulte a referência de EntityTypes.
Os nomes de campo da API são semelhantes aos nomes de campo do Console.
As instruções abaixo destacam as diferenças importantes entre o Console e a API.
Observe que a opção Define synonyms já está marcada.
Clique na primeira linha e forneça um valor de referência na coluna esquerda.
Clique na próxima coluna ou pressione Enter e forneça sinônimos.
Continue adicionando linhas para outras entradas de entidade.
Clique em Save.
Operações em lote
É possível mover, copiar ou excluir várias entidades usando operações em lote:
Copy: copia as entidades selecionadas para o agente de destino.
Move: move as entidades selecionadas para o agente de destino.
Delete: exclui permanentemente as entidades selecionadas.
Esta ação não pode ser desfeita.
As seguintes opções extras são solicitadas para operações de copiar e mover:
Copy related entities: move ou copia entidades usadas em entidades compostas.
Overwrite entities: substitui entidades com o mesmo nome.
Para copiar, mover ou excluir várias entidades:
Passe o mouse sobre a lista e selecione uma ou mais entidades.
Isso revela as opções de lote.
Escolha a ação pretendida.
Selecione as opções pretendidas na caixa de diálogo.
Clique em Start.
Limitações
Considere as seguintes limitações:
Os tipos de entidades personalizadas têm nomes exclusivos para cada agente.
Os nomes de tipo de entidade devem começar com uma letra
e podem conter o seguinte:
A-Z, a-z, 0-9, _ (sublinhado), - (traço).
Os valores de referência de entidade e sinônimos não têm essa limitação.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-18 UTC."],[[["\u003cp\u003eCustom entities can be created to match data specific to an agent, such as defining a \u003ccode\u003evegetable\u003c/code\u003e entity for a grocery store agent.\u003c/p\u003e\n"],["\u003cp\u003eIt is recommended to define entities before adding training phrases to intents in the Dialogflow ES console, as the console will automatically annotate training phrases with existing entities.\u003c/p\u003e\n"],["\u003cp\u003eCustom entity data can be accessed by navigating to the "Entities" section in the left sidebar menu of the Dialogflow ES console and selecting the "Custom" tab.\u003c/p\u003e\n"],["\u003cp\u003eBatch operations allow for copying, moving, or deleting multiple entities at once, with options to copy related entities or overwrite existing ones.\u003c/p\u003e\n"],["\u003cp\u003eCustom entity type names must be unique for each agent and follow specific naming conventions, although reference and synonym values have no such limitations.\u003c/p\u003e\n"]]],[],null,["# Custom entities\n\nYou can create custom entities for matching data specific to your agent.\nFor example, you could define a `vegetable` entity type\nthat can match the types of vegetables\navailable for purchase with a grocery store agent.\n| **Note:** When building your agent, it's best to define your entities prior to adding [training phrases](/dialogflow/docs/intents-training-phrases) to your intents. The console will automatically annotate your training phrases with existing entities. However, if you create entities after training phrases, you can manually annotate the phrases.\n\nWhere to find this data\n-----------------------\n\nWhen building an agent,\nit is most common to use the\nDialogflow ES console ([visit documentation](/dialogflow/docs/console), [open console](https://dialogflow.cloud.google.com)).\nThe instructions below focus on using the console.\nTo access custom entity data:\n\n1. Go to the [Dialogflow ES console](https://dialogflow.cloud.google.com).\n2. Select an agent.\n3. Select **Entities** in the left sidebar menu.\n4. Select the **Custom** tab for custom entities.\n\nIf you are building an agent using the API instead of the console, see the\n[EntityTypes reference](/dialogflow/docs/reference/common-types#entitytypes).\nThe API field names are similar to the console field names.\nThe instructions below highlight any important differences between the console and the API.\n\nCreate custom entities\n----------------------\n\nTo create a custom [map entity](/dialogflow/docs/entities-options#map):\n\n1. Click **Create entity**.\n2. Enter a name for the entity.\n3. Note that **Define synonyms** is already checked.\n4. Click the first row and provide a reference value in the left column.\n5. Click the next column or press **Enter** and provide synonyms.\n6. Continue adding rows for other entity entries.\n7. Click **Save**.\n\nBatch operations\n----------------\n\nYou can move, copy, or delete multiple entities using batch operations:\n\n- **Copy**: Copies selected entities to the target agent.\n- **Move**: Moves selected entities to the target agent.\n- **Delete**: Permanently deletes the selected entities. This cannot be undone.\n\nThe following additional options are prompted for copy and move operations:\n\n- **Copy related entities** : Moves or copies entities used in [composite entities](/dialogflow/docs/entities-options#comp).\n- **Overwrite entities**: Overwrites entities with the same name.\n\nTo copy, move, or delete multiple entities:\n\n1. Hover you mouse over the list and select one or more entities. This reveals the batch options.\n2. Choose the desired action.\n3. Select the desired options in the dialog.\n4. Click **Start**.\n\nLimitations\n-----------\n\nThe following limitations apply:\n\n- Custom entity type names are unique for each agent. Entity type names should start with a letter and can contain the following: `A-Z`, `a-z`, `0-9`, `_` (underscore), `-` (dash). Entity reference and synonym values have no such limitation."]]
