Retornar uma lista de resultados

É comum pedir a um agente para procurar dados em um sistema externo e retornar uma lista de resultados. Para fazer isso, o Microsoft Copilot Studio pode chamar um fluxo do Power Automate para:

• Autenticar e conectar-se a uma solução externa
• Executar uma consulta com base nas entradas do usuário
• Formatar os resultados
• Retornar os resultados para agente

Neste exemplo, você usará o conector do Dataverse no Power Automate para procurar contas. Em seguida, você retornará uma lista de resultados que inclui o nome da conta, a cidade e o número da conta para o Microsoft Copilot Studio.

Pré-requisitos

• Entenda como criar um fluxo na tela de criação do Copilot Studio
• Usar variáveis de entrada e saída para passar as informações
• Configure a pesquisa do Dataverse para o seu ambiente

Configurar uma tabela Contas do Dataverse

A tabela Conta é uma tabela padrão que é incluída automaticamente nos ambientes do Power Platform. No entanto, ela não vem com dados da conta. Antes que seu agente possa procurar contas, você precisará preencher a tabela Conta.

Se você já tem uma tabela Conta com dados, pule esta etapa e vá para Criar um tópico. No entanto, você precisará usar termos de pesquisa diferentes ao testar seu agente em etapas posteriores.

1. Acesse o portal do Power Apps.

2. No painel lateral, no Dataverse, selecione Tabelas.

3. Selecione a tabela Conta e, na página de propriedades da tabela, selecione Editar.

4. Adicione as seguintes linhas à tabela:

   Endereço 1: Cidade	Nome da Conta	Número da Conta
   Seattle	Contoso Inc	AC0125
   São Francisco	Contoso Residences	AC0255
   Olympia	Entrega de Refeições da Contoso	AC0035

Criar um tópico

1. Vá para a página Tópicos do seu agente.

2. Crie um tópico chamado Pesquisa de Conta.

3. Adicione as seguintes frases de gatilho:

   • Procuro um cliente
   • Procuro uma conta
   • Pesquisar conta
   • Pesquisar cliente

4. Adicione um nó Mensagem e insira a mensagem Parece que você está procurando uma conta. Posso procurar isso para você..

5. Adicione um nó Pergunta e insira a mensagem Qual é o nome do cliente que você está procurando?.

6. Em Identificar, selecione Organização.

   A Resposta completa do usuário também funcionará. Entretanto, selecionar a entidade Organização aproveita os recursos de compreensão de linguagem do agente para extrair o nome da organização do resposta.

   

7. Em Salvar resposta como, renomeie a variável como organização.

Criar um fluxo

1. Na tela de criação, selecione Adicionar nó (+). Selecione Chamar uma ação e, depois, Criar um fluxo.

2. No portal do Power Automate, nomeie o fluxo Pesquisar conta.

3. Adicione uma entrada Texto chamada Organização.

   

4. Selecione Inserir uma nova etapa (+) e selecione Adicionar uma ação.

5. Selecione o conector do Microsoft Dataverse e a ação Pesquisar linhas.

   Esta ação usa correspondência difusa para encontrar contas relevantes na tabela Contas do Dataverse.

   

6. Em Pesquisar termo, selecione a variável Organização.

7. Selecione Mostrar opções avançadas e defina os seguintes itens conforme indicado:

   • Item de filtro de tabela: account
   • Classificar por item - 1: @search.score desc
   • Classificar por item - 2: name asc

   

Formatar resultados

A ação Pesquisar linhas retorna a variável Lista de linhas, que contém dados JSON. Antes de poder usar os dados, você precisará analisá-los com a ação Analisar JSON.

1. Selecione Inserir uma nova etapa (+) e selecione Adicionar uma ação.

2. Selecione o conector Operação de Dados e, em seguida, selecione a ação Analisar JSON.

3. Na caixa Conteúdo, em Pesquisar linhas, selecione a variável Lista de linhas.

4. Copie o esquema JSON a seguir e cole-o na caixa Esquema:

   {
       "type": "array",
       "items": {
           "type": "object",
           "properties": {
               "@@search.score": {
                   "type": "number"
               },
               "name": {
                   "type": "string"
               },
               "address1_city": {
                   "type": "string"
               },
               "accountnumber": {
                   "type": "string"
               }
           },
           "required": [
               "name"
           ]
       }
   }
   

   

5. Selecione Inserir uma nova etapa (+) e selecione Adicionar uma ação. Selecione o conector Variável e, em seguida, selecione a ação Inicializar Variável.

6. Em Nome, insira ListOfAccounts. Em Tipo, selecione Cadeia de Caracteres.

   

7. Selecione Inserir uma nova etapa (+) e selecione Adicionar uma ação. Selecione o conector Controle e, em seguida, selecione a ação Aplicar a cada.

8. Selecione a caixa Selecionar uma saída das etapas anteriores para abrir o menu Conteúdo dinâmico. Pesquise corpo e, em Analisar JSON, selecione a variável Corpo.

9. Selecione Inserir uma nova etapa (+) e selecione Adicionar uma ação. Selecione o conector Variável e, em seguida, selecione a ação Acrescentar à variável de cadeia de caracteres.

10. Em Nome, selecione ListOfAccounts. Copie o seguinte texto e cole-o na caixa Valor:

    - @{items('Apply_to_each')['accountnumber']}: @{items('Apply_to_each')['name']} - @{items('Apply_to_each')['address1_city']}
    

11. Adicione uma quebra de linha após o trecho para fazer com que cada resultado apareça em sua própria linha.

    

12. Na ação Retornar valores para o Microsoft Copilot Studio, adicione uma saída Texto. Em Nome, insira FoundAccounts. Em Valor, selecione ListOfAccounts.

    

13. Selecione Salvar.

Chamar o fluxo do Microsoft Copilot Studio

1. Na tela de criação do Microsoft Copilot Studio, selecione Adicionar nó (+) e, em seguida, selecione Chamar uma ação.

2. Selecione o fluxo criado anteriormente, Pesquisar Conta.

3. Em A organização obtém valor de, selecione a variável organização.

4. Adicione um nó Mensagem e insira a mensagem Ok, isso é o que eu encontrei.

5. Adicione um segundo nó Mensagem. Selecione Inserir variável e, em seguida, selecione FoundAccounts.

   

6. Selecione Salvar.

7. Teste seu agente no painel Testar agente .