Criar ações de plug-in de IA para um Microsoft Copilot (versão preliminar)

Importante

As capacidades e os recursos do Power Virtual Agents agora fazem parte do Microsoft Copilot Studio após investimentos significativos em IA generativa e integrações aprimoradas no Microsoft Copilot.

Alguns artigos e capturas de tela podem fazer referência ao Power Virtual Agents enquanto atualizamos a documentação e o conteúdo do treinamento.

As ações de plug-in de IA podem ser usadas para estender um Microsoft Copilot. Eles também podem ser usados dentro de um copiloto personalizado como uma ação do plug-in.

Você pode criar vários tipos de ações de plug-in de IA no Microsoft Copilot Studio:

• Ações de solicitação, que usam o AI Builder e um reconhecimento de linguagem natural para atingir cenários e fluxos de trabalho específicos dentro da empresa.
• Ações de fluxo, que usam fluxos do Power Automate, para realizar ações, recuperar e trabalhar com dados.
• Ações de conector, que usam conectores do Power Platform para acessar dados de outros sistemas, como produtos empresariais conhecidos como Salesforce, Zendesk, MailChimp e GitHub.
• Ações API REST, que usam conexões com APIs REST ou modelos da OpenAI personalizados criados por você.

Este artigo apresenta instruções para criar, compartilhar e publicar ações de plug-in.

Depois de criar ações de plug-in , habilite-as para serem usadas no Microsoft Copilot ou adicione-as a um copiloto personalizado.

O restante deste artigo descreve como criar cada tipo de plug-in.

Gerar conteúdo ou extrair insights com solicitações do AI Builder

Observação: A extensão com ações de solicitação só está disponível para alguns tipos de copilotos.

Para criar ações de solicitação:

1. Entre no Copilot Studio e selecione Biblioteca no painel de navegação lateral.
2. Escolha + Adicionar um item. Você precisará selecionar um Microsoft Copilot para estender.
3. Selecione um dos copilotos a serem estendidos.
4. No Copilot for Microsoft 365, você precisará escolher entre estender o Copilot com um Novo copiloto ou uma Nova ação. Escolha Nova ação.
5. Um menu Nova ação é exibido. Selecione Solicitação.
6. Insira um Nome para a solicitação em Detalhes da solicitação. Use linguagem natural para descrever o que você deseja alcançar, por exemplo, Resuma este texto como um parágrafo com menos de 50 palavras. Você também pode selecionar vários modelos de solicitação predefinidos para ajudar você na introdução a uma solicitação e personalizá-la para o cenário.
7. Em Entrada, adicione variáveis para qualquer informação que você queira dar à solicitação como entrada. Você poderá definir várias entradas, se necessário. Você também pode adicionar dados de exemplo para cada variável de entrada. Por exemplo, se você quiser que um modelo de solicitação resuma um determinado texto, defina uma variável de entrada de texto e adicione um texto de amostra a ser resumido como um teste.
8. Com as variáveis necessárias definidas, adicione uma variável de entrada em Solicitação para cada entrada que o copiloto deve fornecer ao invocar a ação de solicitação. Você poderá adicionar mais de uma variável à solicitação, se quiser receber mais de um dado contextual em runtime do copiloto.
9. Você também pode adicionar tabelas e colunas do Dataverse como dados de justificativa para a resposta da solicitação. Ao adicionar uma tabela e as tabelas relacionadas, você pode informar a solicitação para usá-la como dados de referência a fim de gerar respostas justificadas.
10. Para testar dados de exemplo específicos para as variáveis de entrada, clique em Testar solicitação para avaliar a qualidade do funcionamento da solicitação.
11. Selecione Finalizar solicitação para revisar os detalhes definidos por você para a solicitação.
12. Por fim, selecione Criar ação de solicitação para salvar a ação de solicitação.

Depois de criar a ação, você precisará habilitá-la para uso no Microsoft Copilot.

Para obter mais informações sobre como criar e usar plug-ins de prompt, consulte Prompts do AI Builder.

Automação personalizada com os fluxos do Power Automate

Os plug-ins de fluxo do Power Automate permitem definir fluxos que podem ser chamados de superfícies de IA no Power Platform. Os plug-ins de fluxo usam o novo gatilho Executar do Copiloto e a ação Responder ao Copilot para definir processos personalizados que podem ser invocados com linguagem natural.

Para criar plug-ins de automação:

1. Entre no Copilot Studio e selecione Plugins (versão preliminar) no painel de navegação lateral.
2. Selecione Adicionar um componente do Power Platform como um plug-in de IA.
3. Selecione Automação Personalizada.
4. O editor de fluxo é aberto automaticamente com o gatilho Executar do Copiloto e a ação Responder ao Copilot presente.
5. Você pode adicionar entradas ao seu gatilho para obter informações que deseja coletar de seus usuários. Forneça descrições de texto úteis para cada entrada para que a IA possa identificar corretamente o que extrair dos dados ou entradas de um usuário.
6. Adicione ações ao seu fluxo, como o Criar uma aprovação e Publicar uma mensagem no chat do Teams para criar um processo de aprovação.
7. Como opção, adicione parâmetros à ação Responder ao copiloto para qualquer saída que você deseja enviar de volta ao copiloto.
8. Salve seu fluxo com um nome de fluxo significativo e teste-o ou execute-o pelo menos uma vez. A IA usa o título e a descrição do fluxo para determinar quando invocar os plug-ins de fluxo. Verifique se os fluxos são executados corretamente, pois apenas fluxos testados aparecem como plugins disponíveis no Microsoft Copilot.

Depois de criar a ação, habilite-a para uso no Microsoft Copilot.

Criar uma ação de conector

As ações de conector permitem definir conectores que podem ser chamados a partir das superfícies de IA no Power Platform. Os plug-ins de conector exigem a identificação de ações habilitadas para uso no Microsoft Copilot e a captura de informações que modelos de linguagem grandes exigem para identificar e utilizar efetivamente o plug-in, como os campos Resumo e Descrição.

Copilot for Microsoft 365

Adição de uma ação de conector para o Copilot for Microsoft 365

Você deve ter credenciais no nível de criador e receber uma licença de copiloto e uma licença do Microsoft Teams para criar uma ação do plug-in para Microsoft 365.

Para adicionar uma ação de conector ao Copilot for Microsoft 365:

1. Na home page, selecione Copilotos

2. Na lista Copilotos, na navegação no lado esquerdo, selecione Copilot for Microsoft 365

3. A página principal do Copilot será exibida na guia Configurar. Aqui, você poderá consultar uma lista das ações já presentes dentro do copiloto se selecionar a guia Extensões.

4. Para criar um novo plug-in, selecione Adicionar extensão e Nova ação.

5. Você recebe uma lista de todos os tipos de ação compatíveis. Selecione Conector.

6. Você recebe uma lista de conectores disponíveis para seleção. Essa lista inclui todos os conectores certificados oferecidos pela Microsoft, bem como todos os conectores personalizados presentes no ambiente atual em uso. Uma barra de pesquisa está disponível para ajudar a encontrar o conector que você deseja usar. Encontre o conector e o selecione.

7. A página Detalhes da ação é exibida. Escreva um nome e uma descrição para a ação do conector. O nome da ação deve ser exclusivo. Por padrão, ele usará o nome do conector escolhido. Você deve adicionar informações de definição adicionais para garantir que ele seja um nome exclusivo e fácil de discernir o que faz para usuários que queiram habilitá-lo depois. Leve em consideração a inclusão na descrição os tipos de ações que ele permite como "Serviço de email – permite a você recuperar e criar mensagens".

A descrição poderá ser fornecida a você se estiver presente no conector selecionado. A descrição é usada pelo Copilot para identificar quando essa ação pode ser usada para obter respostas para a solicitação do usuário. Por isso, deixe isso o mais detalhado e descritivo possível. Dê detalhes específicos usando termos que você espera que os usuários usem ao chamar a ação. Para continuar o exemplo de serviço de email acima, convém incluir algo como:

"O Serviço de Email oferece a capacidade de obter listas de mensagens existentes, recuperar pastas onde as mensagens são armazenadas, listar títulos de mensagens e pastas, obter mensagens, atualizar títulos e corpos de mensagem, definir prioridade para mensagens..."

Quanto mais específico e detalhado, melhor, pois, assim, o copiloto poderá saber facilmente a usar o plug-in sem ser instruído, o que possibilita uma experiência de linguagem mais natural.

8. Em Solução, selecione uma solução na qual o plug-in será armazenado. Para obter mais informações sobre quais são as soluções e por que elas beneficiam você, consulte Conceitos de solução. O menu suspenso vai listar todas as soluções disponíveis dentro do ambiente atual. Selecione aquela que você gostaria de usar.

Se você tiver uma solução preferida ou se o conector selecionado já estiver na solução, essa solução será selecionada automaticamente. Você pode selecionar uma solução ou deixá-la em branco. Se deixar em branco, uma solução vai ser criada para você com "nome da ação" e editor padrão. Isso vai garantir que a ação seja sempre armazenada em uma solução, de maneira que você possa movê-la facilmente os ambientes.

Observação

Você não verá uma solução padrão ou uma solução padrão CDS como uma opção nesse caso, pois recomendamos ter uma solução personalizada tendo em vista um gerenciamento mais fácil. Consulte o link aqui para entendê-los melhor: Solução padrão X solução personalizada.

9. Depois que isso for concluído, selecione Avançar.

10. A página Selecionar Ações é exibida. Isso mostra todas as ações disponíveis para o conector escolhido por você. Qualquer uma ou todas as ações podem ser configuradas para uso. Uma barra de pesquisa está incluída para ajudar você a encontrar a ação que deseja selecionar. Não há limite para o número de ações que você pode selecionar para o plug-in.

Observação

Somente as ações selecionadas e configuradas por você poderão ser executadas pelo plug-in. Mesmo que estejam listadas nessa lista como disponíveis, se não tiverem sido configuradas, elas não vão funcionar no plug-in. Se não estiver presente, uma ação não poderá ser usada. Não é possível adicionar nem remover ações de um conector dentro do assistente de ações do Copilot Studio.

Selecione uma ação para continuar.

11. A página Configurar Ação é exibida.

Dê um nome e uma descrição para a ação. O nome não precisa ser exclusivo nesse caso. É provável que esses valores sejam populados por você pelo conector, mas, assim como acontece com a descrição do plug-in, é recomendável dar uma descrição específica detalhada para que o copiloto saiba quando invocar a ação específica. Isso ajuda a permitir uma abordagem de linguagem mais natural para selecionar a ação a ser executada. Por exemplo, se uma ação for "Listar pastas de mensagens", você poderá usar:

"Listar pastas de mensagens permite a você obter uma lista de todas as pastas de mensagens disponíveis no serviço de email. Isso vai recuperar todas as pastas, colocá-las em uma exibição de lista e as retornará para você."
Isso acaba usando as pistas de contexto "listar pastas de mensagens", bem como: obter, tudo, recuperar, lista, serviço de email, retornar, pastas e exibir.

12. Quando você terminar essa página, selecione Avançar.

13. A página Selecionar parâmetros de ação é exibida.

    Aqui todas as entradas e saídas da ação são listadas. Essa lista é fornecida pelo conector e não pode ser alterada, mas as descrições podem ser modificadas. Essas descrições não afetarão o copiloto. Elas simplesmente oferecem clareza para criadores futuros que gerenciam essa ação.

14. Os usuários podem clicar em Avançar ou em Ignorar etapas opcionais. • Avançar vai levar os usuários em meio às etapas para cartões adaptáveis e iniciadores de conversa. Se você quiser usá-los, use o botão Avançar. Avance à etapa 19. • Ignorar etapas opcionais vai ignorar essas etapas e levar você até o final do assistente, onde o teste e a publicação ocorrem. As páginas ignoradas podem ser concluídas a qualquer momento editando o plug-in. Se você optar por ignorar a configuração dessas etapas no momento, avance à etapa 30.

15. Clique em Avançar

16. A página Selecionar Ações é exibida, mostrando a ação que você acabou de configurar.

17. Você poderá selecionar outra ação e repetir as etapas de 10 a 15 ou selecionar Avançar se tiver terminado de adicionar ações.

18. A tela Revisar e Testar é exibida. Esta página exibe os detalhes de todas as etapas de configuração até o momento. Você pode revisá-las e, em seguida, testar a ação antes da publicação.

19. Selecione a conexão existente no menu suspenso ou crie uma Nova conexão se você não tiver nenhuma conexão.

20. Ao selecionar Nova conexão, um assistente é aberto no qual você pode adicionar detalhes como nome de usuário, senha e assim por diante para compilar a conexão.

21. Depois que uma conexão for definida, selecione Testar. Depois de ver a mensagem de que ela está pronta para ser testada, vá até o chat do Copilot para M365. Abra o submenu para ver a ação criada e a ative.

22. A ação é exibida com um ícone de béquer sob o conector escolhido com o formato Nome de Teste-ação. Você já pode testar a ação tentando as solicitações esperadas que um usuário utilize. Você também pode usar o comando –developer on para obter mais informações sobre a execução da solicitação. Assim que você estiver satisfeito com os resultados, retorne ao Copilot Studio.

23. Depois que você tiver concluído os testes, selecione Publicar.

24. Uma página mostrando que a ação está no processo de publicação é exibida. Quando concluído, você verá uma página indicando que a ação foi publicada. Você pode clicar na página Ir para detalhes a fim de ver os detalhes da ação publicada. Agora que foi publicada, a ação deverá ser habilitada por um administrador para poder ser usada no copiloto.

25. Você também pode mover facilmente uma ação de um ambiente para outro usando uma solução. Para isso, selecione Exportar na página Exportar esta solução. Isso vai permitir a você exportar a ação. Altere o número da versão, se necessário, e selecione se a solução deve ser gerenciada ou não gerenciada. Gerenciada significa que a alteração deverá ser feita e não gerenciada se você quiser fazer alterações na solução no ambiente de destino. Depois da conclusão, você verá uma mensagem verde com a opção Baixar a solução e salvá-la como um arquivo .zip no sistema.

Observação

Você não precisa selecionar a publicação no painel de soluções.

25. Selecione Importar Solução no ambiente de destino. Selecione o arquivo .zip e continue. Você verá a ação importada na lista.

Copilot for Sales

Para estender o Copilot for Sales, existem alguns pré-requisitos:

• Você deve estar conectado a um ambiente que contenha o ambiente do Copilot for Sales que deseja estender. Se for um cliente do Salesforce, você precisará estar conectado ao ambiente do Dataverse criado (normalmente chamado de msdyn_viva).
• Você já deve ter feito logon no Copilot for Sales por meio do Outlook no ambiente que deseja estender pelo menos uma vez antes da extensão.
• Você deve ter credenciais no nível de criador e receber uma licença de copiloto e uma licença do Microsoft Teams para criar um plug-in para Copilot for Sales.

Para adicionar uma ação de conector ao Copilot for Sales:

1. Na home page, selecione Copilotos.

2. Na lista Copilotos, na navegação no lado esquerdo, selecione Copilot for Sales. A página principal do Copilot é exibida na guia de configuração.

3. Selecione a guia Ações para consultar uma lista das ações já presentes dentro do Copilot.

4. Para criar um novo plug-in, selecione Adicionar Ações

5. Uma lista de todos os tipos de ação compatíveis é mostrada. Selecione Conectores.

Observação

No momento, só há conectores disponíveis para o Copilot for Sales. Isso pode mudar no futuro.

Uma lista que mostra todos os conectores é exibida.

Essa lista inclui todos os conectores fornecidos pela Microsoft, bem como todos os conectores personalizados presentes no ambiente atual.

Observação

No momento, conectores personalizados não podem ser usados para estender o Copilot for Sales.

6. Uma barra de pesquisa está disponível para ajudar a encontrar o conector que você deseja usar. Encontre o conector e o selecione.

A página Detalhes da Ação é exibida. Nesta página, dê um nome e uma descrição para o plug-in.

O nome da ação deve ser exclusivo. O padrão será o nome do conector escolhido. Você deve adicionar informações de definição adicionais para garantir que o nome seja exclusivo e fácil de discernir o que o conector faz para usuários que queiram habilitá-lo depois. Leve em consideração a inclusão dos tipos de ações que ele permite como "Serviço de email – permite a você recuperar e criar mensagens".

A descrição poderá ser fornecida a você se estiver presente no conector selecionado. A descrição será usada pelo Copilot para saber quando usar o plug-in para obter respostas, logo, crie-a com o máximo de detalhes e descrições possível. Dê detalhes específicos usando termos que você espera que os usuários usem ao usar o plug-in. Para continuar o exemplo de serviço de email acima, convém incluir algo como:

"O Serviço de Email oferece a capacidade de obter listas de mensagens existentes, recuperar pastas onde as mensagens são armazenadas, listar títulos de mensagens e pastas, obter mensagens, atualizar títulos e corpos de mensagem, definir prioridade para mensagens..."

Quanto mais específico e detalhado, melhor, pois, assim, o copiloto poderá saber facilmente a usar o plug-in sem ser instruído, o que possibilita uma experiência de linguagem mais natural.

7. Apresente uma solução. Solução define a solução na qual o plug-in será armazenado. Para obter mais informações sobre quais são as soluções e por que elas beneficiam você, consulte Conceitos de solução. Um menu suspenso vai mostrar todas as soluções disponíveis dentro do ambiente atual. Você pode selecionar aquela que gostaria de usar.

Se você tiver uma solução preferida ou se o conector selecionado já estiver na solução, essa solução será selecionada automaticamente. Você pode selecionar uma solução ou deixá-la em branco. Se deixar em branco, uma solução vai ser criada para você com "nome da ação" e editor padrão. Isso vai garantir que a ação seja sempre armazenada em uma solução, de maneira que você possa movê-la facilmente os ambientes.

Observação

Você não verá uma solução padrão ou uma solução padrão CDS como uma opção nesse caso, pois recomendamos ter uma solução personalizada tendo em vista um gerenciamento mais fácil. Consulte o seguinte link para entender melhor: Solução padrão X solução personalizada.

8. Assim que a solução for escolhida, selecione Avançar.

A página Selecionar Ações é exibida. Isso mostra todas as ações disponíveis para o conector escolhido por você. Qualquer uma ou todas as ações podem ser configuradas para uso. Uma barra de pesquisa está incluída para ajudar você a encontrar a ação que deseja selecionar. Não há limite para o número de ações que você pode selecionar para o plug-in.

Observação

Somente as ações selecionadas e configuradas por você poderão ser executadas pelo plug-in. Mesmo que estejam listados nessa lista como disponíveis, se não tiverem sido configurados, eles não vão funcionar no plug-in.
Se não estiver presente, uma ação não poderá ser usada. Não é possível adicionar nem remover ações de um conector dentro do assistente de ações do Copilot Studio.

9. Selecione uma ação para continuar. A página Configurar Ação é exibida para essa ação escolhida.

Dê um nome e uma descrição para a ação. O nome não precisa ser exclusivo nesse caso. É provável que esses valores sejam populados para você pelo conector. No entanto, assim como acontece com a descrição do conector, é uma boa ideia apresentar uma descrição específica detalhada. Assim, o copiloto sabe quando invocar a ação específica. Isso ajuda a permitir uma abordagem de linguagem mais natural para selecionar a ação a ser executada. Por exemplo, se uma ação for "Listar pastas de mensagens", você poderá usar:

"Listar pastas de mensagens permite a você obter uma lista de todas as pastas de mensagens disponíveis no serviço de email. Isso vai recuperar todas as pastas, colocá-las em uma exibição de lista e as retornará para você."

Isso acaba usando as pistas de contexto "listar pastas de mensagens", bem como: obter, tudo, recuperar, lista, serviço de email, retornar, pastas e exibir.

10. Depois de completar a página, selecione Avançar. A página Parâmetros de Ação é exibida.

11. A página Parâmetros da ação lista todas as entradas e saídas da ação. Essa lista é fornecida pelo conector e não pode ser alterada, mas as descrições podem ser modificadas. Essas descrições não vão afetar o copiloto, mas vão esclarecer para futuros criadores que gerenciarem essa ação. Essa lista também dá um insight sobre os tipos de dados necessários para consultas os tipos de saídas esperados. Ela pode ser usada para ajustar as descrições que já foram inseridas ou para os iniciadores de conversa.

12. Selecione Avançar para continuar.

13. A página Selecionar Ações é exibida, mostrando a ação que você acabou de configurar.

Você poderá selecionar outra ação e repetir as etapas de 9 a 12 ou selecionar Avançar se tiver terminado de adicionar ações.

Uma tela Revisar e Testar é exibida.

14. A página Revisar e testar exibe os detalhes de todas as etapas de configuração até o momento. Você pode revisá-las e, em seguida, testar o plug-in antes da publicação.

Selecione a conexão existente no menu suspenso ou crie uma nova conexão se você não tiver nenhuma conexão.

15. Ao selecionar Nova conexão, um assistente é aberto no qual você pode adicionar detalhes como nome de usuário, senha e assim por diante para compilar a conexão.

16. Depois que uma conexão for selecionada, selecione Testar.

17. Assim que você vir a mensagem de que ela está pronta para ser testada, vá até o chat do Copilot for Sales, abra o submenu para ver a ação criada e a ative.

18. A ação é exibida com um ícone de béquer sob o conector escolhido com o formato Nome de Teste-ação.

Você já pode testar o plug-in tentando as solicitações esperadas que um usuário utilize. Você também pode usar o comando –developer on para obter mais informações sobre a execução da solicitação. Assim que você estiver satisfeito com os resultados, retorne ao Copilot Studio.

19. Assim que você tiver concluído os testes, selecione Publicar.

Uma página mostrando que o plug-in está no processo de publicação é exibida. Quando concluído, você verá uma página indicando que o plug-in foi publicado.

20. Selecione Ir para detalhes a fim de ver os detalhes do plug-in publicado.

Agora que foi publicado, o plug-in deverá ser habilitado por um administrador para poder ser usado no copiloto.

21. Você também pode mover facilmente um plug-in de um ambiente para outro usando uma solução. Para isso, clique em Exportar esta solução na página de detalhes. Isso vai permitir a você exportar a ação.

22. Altere o número da versão, se necessário, e selecione se a solução deve ser Gerenciada ou Não Gerenciada.

Gerenciada significa que você não vai fazer nenhuma alteração e não gerenciada significa que convém fazer alterações na solução no ambiente de destino. Depois da conclusão, você verá uma mensagem verde com a opção "Baixar" a solução, que vai salvar um arquivo .zip no sistema.

Observação

Você não precisa selecionar a Publicar no painel de soluções.

23. Selecione Importar Solução no ambiente de destino. Selecione o arquivo .zip e continue. Você vai ver a ação importada que vai começar a ser exibida na lista Ações.

Copilot no Dynamics 365 Customer Service

Alguns pré-requisitos são necessários para estender um Copilot no Dynamics 365 for Customer Service:

• Você deve estar conectado a um ambiente que contenha o Copilot que deseja estender.
• Você deve ter credenciais no nível de criador no ambiente e receber uma licença de copiloto e uma licença do Microsoft Teams para criar um plug-in.

Para adicionar uma ação de conector ao Copilot for Dynamics 365 Customer Service:

1. Na home page, selecione Copilotos.

2. Na lista Copilotos, na navegação no lado esquerdo, selecione Copilot no Dynamics 365 for Customer Service

A página principal do Copilot é exibida na guia Configurar. Aqui, você poderá consultar uma lista das ações já presentes dentro do copiloto se selecionar a guia Ações.

3. Para criar uma nova ação, selecione Adicionar Ações. Uma lista de todos os tipos da fonte de conteúdo compatíveis é relacionada.

4. Selecione Conector.

Observação

No momento, somente conectores e solicitações estão disponíveis como extensões para o Copilot no Dynamics 365 for Customer Service. Isso pode mudar no futuro.

Uma lista com todos os conectores é exibida.

Essa lista inclui todos os conectores fornecidos pela Microsoft, bem como todos os conectores personalizados presentes no ambiente atual. Uma barra de pesquisa está disponível para ajudar a encontrar o conector que você deseja usar.

5. Encontre o conector que você deseja usar e o selecione. A página Detalhes da Ação é exibida.

6. Dê um nome e uma descrição para o plug-in.

• O nome da ação deve ser exclusivo. Por padrão, ele vai mostrar o nome do conector escolhido. Você deve adicionar informações de definição adicionais para garantir que ele seja um nome exclusivo e fácil de discernir o que faz para usuários que queiram habilitá-lo depois. Leve em consideração a inclusão dos tipos de ações que ele permite como "Serviço de email – permite recuperar e criar mensagens".
• A descrição poderá ser fornecida a você se estiver presente no conector selecionado. A descrição será usada pelo Copilot para saber quando usar o plug-in para obter respostas, logo, crie-a com o máximo de detalhes e descrições possível. Dê detalhes específicos usando termos que você espera que os usuários usem ao usar o plug-in. Para continuar o exemplo de serviço de email acima, convém incluir algo como:

"O Serviço de Email oferece a capacidade de obter listas de mensagens existentes, recuperar pastas onde as mensagens são armazenadas, listar títulos de mensagens e pastas, obter mensagens, atualizar títulos e corpos de mensagem, definir prioridade para mensagens..."

Quanto mais específico e detalhado, melhor, pois, assim, o copiloto poderá saber facilmente a usar o plug-in sem ser instruído, o que possibilita uma experiência de linguagem mais natural.

7. Em seguida, defina a solução para identificar onde o plug-in será armazenado. Para obter mais informações sobre quais são soluções e por que elas beneficiam você, consulte Conceitos da solução. O menu suspenso lista todas as soluções disponíveis dentro do ambiente atual, e você pode escolher aquela que deseja usar.

Se você tiver uma solução preferida ou se o conector selecionado já estiver na solução, essa solução será selecionada automaticamente. Você pode selecionar uma solução ou deixá-la em branco. Se deixar em branco, uma solução vai ser criada para você com "nome da ação" e editor padrão. Isso vai garantir que a ação seja sempre armazenada em uma solução, de maneira que você possa movê-la facilmente os ambientes.

Observação

Você não verá uma solução padrão ou uma solução padrão CDS como uma opção nesse caso, pois recomendamos ter uma solução personalizada tendo em vista um gerenciamento mais fácil. Consulte o link aqui para entendê-los melhor: Solução padrão X solução personalizada – Power Platform | Microsoft Learn

8. Com as configurações definidas, selecione Avançar.

A página Selecionar Ações é exibida. Isso mostra todas as ações disponíveis para o conector escolhido por você. Qualquer uma ou todas as ações podem ser configuradas para uso. Uma barra de pesquisa está incluída para ajudar você a encontrar a ação que deseja selecionar. Não há limite para o número de ações que você pode selecionar para o plug-in.

Observação

Somente as ações selecionadas e configuradas por você poderão ser executadas pelo plug-in. Mesmo que estejam listadas na lista como disponíveis, se não tiverem sido configuradas, elas não vão funcionar no plug-in.
Se não estiver presente, uma ação não poderá ser usada. Não é possível adicionar nem remover ações de um conector dentro do assistente de ações do Copilot Studio.

9. Selecione uma ação para continuar. A página Configurar Ação é exibida.

10. Dê um nome e uma descrição para a ação. O nome não precisa ser exclusivo nesse caso. É provável que esses valores sejam populados para você pelo conector. No entanto, assim como acontece na descrição do plug-in, é recomendável dar uma descrição específica detalhada, de maneira que o copiloto saiba quando invocar a ação específica. Isso ajuda a permitir uma abordagem de linguagem mais natural para selecionar a ação a ser executada. Por exemplo, se uma ação for "Listar pastas de mensagens", você poderá usar:

"Listar pastas de mensagens permite a você obter uma lista de todas as pastas de mensagens disponíveis no serviço de email. Isso vai recuperar todas as pastas, colocá-las em uma exibição de lista e as retornará para você."

Isso acaba usando as pistas de contexto "listar pastas de mensagens", bem como: obter, tudo, recuperar, lista, serviço de email, retornar, pastas e exibir.

11. Quando você terminar essas configurações nessa página, selecione Avançar. A página Parâmetros de Ação é exibida.

    Na página Parâmetros da Ação, uma lista de todas as entradas e saídas da ação é exibida. Essa lista é fornecida pelo conector e não pode ser alterada, mas as descrições podem ser modificadas. Essas descrições não afetarão o copiloto. Elas simplesmente oferecem clareza para criadores futuros que gerenciam o conector. Essa lista também dá um insight sobre os tipos de dados necessários para consultas o tipo de saídas esperado. Ela pode ser usada para ajustar as descrições que já foram inseridas ou para os iniciadores de conversa.

12. Selecione Avançar para continuar.

A tela Revisar e Publicar é exibida.

13. A página Revisar e Publicar exibe os detalhes de todas as etapas de configuração até o momento. Você pode revisá-las e, em seguida, testar a ação antes da publicação.

Observação

Esta página faz menção de testar a ação. No momento, o Copilot no Dynamics 365 for Customer Service não possibilita testes dentro do assistente. Quando esse recurso estiver disponível, você poderá testar o plug-in nessa tela. Por ora, os usuários deverão publicar o plug-in e, em seguida, podem validar se ele está funcional dentro do Copilot no Dynamics 365 for Customer Service logo depois de ser habilitado por um administrador.

Assim que você tiver concluído a revisão, selecione Publicar. Uma página mostrando que o plug-in está no processo de publicação é exibida.

14. Depois que a publicação for concluída, você poderá ver uma página indicando que o conector foi publicado. Selecione a página Ir para detalhes a fim de ver os detalhes da ação publicada. Agora que foi publicada, a ação deverá ser habilitada por um administrador para ser usada no copiloto.

15. Você também pode mover facilmente uma ação de um ambiente para outro usando uma solução. Para isso, selecione Exportar esta solução na página de detalhes. Isso vai permitir a você exportar a ação.

16. Altere o número da versão, se necessário, e selecione se a solução deve ser gerenciada ou não gerenciada.

17. Você também pode mover facilmente um plug-in de um ambiente para outro usando uma solução. Para isso, selecione Exportar esta solução na página de detalhes. Isso vai permitir a você exportar a ação.

18. Altere o número da versão, se necessário, e selecione se a solução deve ser gerenciada ou não gerenciada. Gerenciada significa que nenhuma outra alteração precisa ser feita e não gerenciada permite a você fazer alterações na solução no ambiente de destino. Depois da conclusão, você verá uma mensagem verde com a opção Baixar a solução e salvar como um arquivo .zip no sistema.

Observação

Você não precisa clicar na publicação no painel de soluções.

17. Selecione Importar Solução no ambiente de destino. Selecione o arquivo .zip e continue. Você verá a ação importada começar a ser exibida na lista.