1. Clique em Entidades na barra de navegação esquerda.

2. Clique em Adicionar Entidades.

3. Escolha Repositório Composto como tipo de entidade.

4. Digite o nome e a descrição.
5. Clique em + Handler de Eventos se desejar usar o prompt e a lógica da entidade composta de forma programática usando handlers de evento de entidade.

6. Clique em + Item de Repositório para abrir a caixa de diálogo Adicionar Item de Repositório. Se você estiver adicionando uma entidade incorporada ou uma entidade personalizada existente, poderá criar um nome específico do repositório para ela e adicionar uma descrição de sua atribuição dentro do contexto do repositório composto.

7. Você pode preencher o repositório com entidades personalizadas, entidades incorporadas e o seguinte:

   • STRING — Captura o texto livre do usuário.

   • LOCATION — Captura a localização do usuário.

   • ATTACHMENT — Aceita arquivos, arquivos de áudio, vídeo ou arquivos de imagem submetidos a upload pelo usuário. A entidade composta armazena o URL no qual o anexo é hospedado.

   Observação
   
   Será solicitado que você informe um subtipo quando adicionar a entidade DATE_TIME.

   Os itens são resolvidos na ordem em que são adicionados. No entanto, a sequência pode ser afetada, dependendo de como você configura membros individuais do repositório composto.

8. Se você clicar em Fechar, retornará à página Entidades, mas poderá primeiro adicionar outros recursos específicos do repositório ao item (ou atualizá-lo posteriormente, clicando em na página Entidades).

9. Próximas etapas:

   • Adicione mensagens de erro individuais, prompts de desambiguação ou prompts condicionais para os itens do repositório.
     Observação
     
     Elas serão substituídas se você adicionar a entidade a uma entidade composta.

   • Adicione a entidade a uma intenção. Consulte Adicionar Entidades a Intenções.

   • Configure o fluxo de caixas de diálogo para usar a entidade composta..

• Somente o item que está resolvendo no momento será atualizado. Quando uma correspondência se aplica a mais de um item de bolsa, o item de bolsa que está resolvendo no momento tem precedência sobre outros itens. Se você desativar o preenchimento de slot aprimorado, todos os itens serão atualizados com o mesmo valor.
• Se o item de resolução atual for um item de repositório STRING, nenhum outro item de repositório será atualizado.
• Se uma correspondência de entidade se aplicar a vários itens de repositório (não resolvidos), uma caixa de diálogo de desambiguação será exibida, permitindo que o usuário escolha qual item deve ser atualizado em vez de atualizar todos os itens de repositório.
• A chave Prompt para Desambiguação da entidade é ignorada. Recomendamos que você implemente a desambiguação personalizada com um handler de eventos de entidade.

1. Se quiser ativar os prompts, deixe o campo Solicitar Valor em branco (seu estado padrão). Se você digitar false no campo Solicitar Valor vai impedir os prompts. Para solicitar um valor condicional, adicione uma expressão booliana do FreeMarker que seja avaliada como true (para prompts) ou false.

   Dica:

   Quando você define Solicitar Valor como false, o item ainda pode ser resolvido como parte de outro item que está sendo solicitado ao ativar Extração Fora da Ordem.
2. Clique em Adicionar Prompt para criar a sequência de prompts. É possível reordená-los misturando os campos com gestos de arrastar e soltar ou renumerando-os. Você pode tornar aleatória a saída dos prompts quando dá a dois ou mais prompts o mesmo número.

   Observação
   
   Você só pode adicionar prompts para entidades incorporadas quando adicioná-los a um repositório composto.

   Os prompts podem ser armazenados em pacotes de recursos (por exemplo, ${rb.askCheese}) ou gravados como combinações de expressões de texto e do FreeMarker.

• Sempre - A opção padrão. Quando você escolhe essa opção para um item, seu valor pode ser preenchido no slot sem qualquer prompt. Por exemplo, a entidade PizzaSize pode ser resolvida quando um cliente digita I want a large pizza. Essa opção também permite que o valor do item seja alterado a qualquer momento, desde que a expressão na propriedade Atualizável não seja avaliada como false. Por exemplo, quando o repositório composto solicita a entidade PizzaType, o cliente pode responder Pizza vegetariana, mas torná-la média. A habilidade pode atualizar o valor da entidade PizzaSize com média sem reiniciar a conversa porque Sempre está ativado para os itens PizzaSize e PizzaType do bag.
  Observação
  
  Embora essa opção seja o comportamento padrão, pode nem sempre ser apropriada para itens STRING. Se você escolher essa opção para um item STRING, por exemplo, a primeira mensagem do usuário será armazenada pelo item STRING em vez de ser correspondida pela entidade pretendida (que pode ser designada como o primeiro item no repositório a ser resolvido).
• Nunca - Quando você escolhe essa opção, o item só é colocado no slot após ser solicitado, mesmo quando outras mensagens do usuário contêm valores válidos. Escolha Nunca para evitar correspondências inadvertidas.
• Somente ao resolver a declaração de intenção - Restringe o slot de valor fora da ordem à primeira declaração do usuário que foi resolvida para a intenção associada à entidade composta.

• O repositório composto tem duas entidades relacionadas a endereço: NamedAddress, uma entidade de valor de lista com valores como casa e escritório, e DeliveryAddress, uma entidade ADDRESS.
• O prompt da entidade DeliveryAddress é Where do you want that delivered?
• A entidade NamedAddress não solicita entrada (false foi informado no campo Prompt de Valor).
• A entidade NamedAddress pode ser extraída com DeliveryAddress (DeliveryAddress está selecionado no menu Extrair com).

${varName.value.itemName}

${expense.value.Amount.amount > 4}

Amounts below 5 ${expense.value.Amount.currency} cannot be expensed. Enter a higher amount or type 'cancel'.

• userInput
• prompt
• promptCount
• updatedEntities
• outOfOrderMatches
• disambiguationValues
• enumValues
• needShowMoreButton
• rangeStartVar
• nextRangeStart

Sorry,'${system.entityToResolve.value.userInput!'this'}' is not a valid pizza size.

    metadata:
      responseItems:        
      - type: "text" 
        text: "<#list system.entityToResolve.value.updatedEntities>I have updated <#items as ent>${ent.description}<#sep> and </#items>. </#list><#list system.entityToResolve.value.outOfOrderMatches>I got <#items as ent>${ent.description}<#sep> and </#items>. </#list>"
      - type: "text" 
        text: "${system.entityToResolve.value.prompt}"
        actions:
        - label: "${enumValue}"
          type: "postback"
          iteratorVariable: "system.entityToResolve.value.enumValues"

        globalActions: 
        - label: "Show More"
          type: "postback" 
          visible:
            expression: "${system.entityToResolve.value.needShowMoreButton}"
          payload:
            action: "system.showMore"
            variables: 
              ${system.entityToResolve.value.rangeStartVar}: ${system.entityToResolve.value.nextRangeStart} 
        - label: "Cancel"
          type: "postback" 
          visible:
            onInvalidUserInput: true
          payload:
            action: "cancel"

Observação

Você pode gerenciar o serviço implantado para o EEH na página Componentes .

ExpenseDate: {

        validate: async (event, context) => {
          if (new Date(event.newValue.date) > new Date()) {
            context.addValidationError("ExpenseDate",context.translate('ExpenseDate.text'));
            return false;
          }          
        }

1. Antes de criar um item de repositório DATE_TIME, configure as regras de resolução de ambiguidade de data e hora apropriadas para seu caso de uso. Por exemplo, se você estiver criando uma habilidade de relatório de despesas, selecione Passado. Se a habilidade for um programador de reuniões, selecione Futuro.
2. Na entidade composta, clique em Adicionar item.
3. Selecione Entidade no menu Tipo.
4. Selecione DATE_TIME no menu Nome da Entidade.
5. Escolha um subtipo DATE_TIME no menu Subtipo.
   
   
   Descrição da ilustração select-date-time-subtype.png
   
   As opções de configuração na página Adicionar Item Bolsa são alteradas, dependendo do subtipo selecionado. Por exemplo, se você selecionar o subtipo Recorrente, poderá acessar opções de configuração para os itens de repositório aninhados que são específicos para definir um evento repetido, como o objeto Data e Hora para a data e hora iniciais e o objeto Duração para definir a frequência do evento.
   
   
   Descrição da ilustração edit-date-time-bag-item.png
   
   
6. Se você selecionou os subtipos Recorrente ou Intervalo:
   • Defina os valores de subtipo que o repositório composto solicita no menu Solicitar.
   • Como as reuniões geralmente começam e terminam no mesmo dia, ative Data final padrão para a data inicial para o subtipo startDate. Isso define a data de término como igual à data de início quando a mensagem do usuário não menciona a data de término (ou quando a data de término não é extraída fora de ordem).
     
     
     
     
7. Opcionalmente, adicione um label de desambiguação se a entrada do usuário puder corresponder a mais de um subtipo.

   Dica:

   Você também pode configurar as propriedades que não são específicas de DATE_TIME, como preenchimento de slot aprimorado, atualização de valores de slot com Apache FreeMarker, prompts personalizados e mensagens de erro.
8. Você pode acessar a configuração no nível do subtipo clicando em um subtipo. Use a travessia para retornar à configuração no nível do item.
   
   
   
   
9. Próximas etapas:
   • Associe a entidade composta à intenção.
   • Declare uma variável para a entidade no fluxo de caixas de diálogo.
   • No fluxo de caixas de diálogo, faça referência à entidade composta com o item DATE_TIME usando um estado Resolver Entidade Composta.
   • Os valores DATE_TIME são representados como ISO 8601. Para uma saída amigável, use o Apache FreeMarker .xs built-in. No trecho de código a seguir, o valor do subtipo Tempo é formatado usando .value?time.xs?string['hh:mm a'].

     Your pizza will be delivered at ${pizza.value.deliveryTime.value?time.xs?string['hh:mm a']}.
     

     Em vez de fazer referência ao item DATE_TIME como uma string, você pode seguir a abordagem de melhores práticas de referenciá-lo em um pacote de recursos, como DeliveryMessage no exemplo a seguir.

     ${rb('DeliveryMessage','time',pizza.value.deliveryTime.value?time.xs?string['hh:mm a'])}
     

     Para a mensagem do pacote de recursos DeliveryMessage, o valor é renderizado por meio do parâmetro {time}:

     Your pizza will be delivered at {time}.