Usar ações com copilotos personalizados (versão preliminar)

Você pode estender as capacidades do copiloto adicionando uma ou mais ações. As ações são usadas pelo copiloto para responder automaticamente aos usuários usando ações generativas, ou você pode chamá-las explicitamente dentro de um tópico.

[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Tipos de ação básica

Se você ativar o modo generativo, o copiloto poderá selecionar automaticamente a ação ou o tópico mais indicado para responder a um usuário em runtime.

Em modo clássico, um copiloto só pode usar tópicos para responder ao usuário. No entanto, você ainda pode projetar o copiloto para chamar explicitamente ações dentro dos tópicos.

As ações se baseiam em um dos seguintes tipos de ação básica:

• Ação do conector predefinida
• Ação do conector personalizado
• Fluxo de nuvem do Power Automate
• Solicitações do AI Builder
• Habilidade do Bot Framework

Cada ação básica tem informações adicionais que descrevem a finalidade, o que permite que o copiloto use IA generativa para gerar perguntas. Essas perguntas são necessárias a fim de preencher as entradas necessárias para realizar a ação. Por isso, você não precisa criar manualmente nós de pergunta para reunir todas as entradas necessárias, como as entradas em um fluxo. As entradas são tratadas para você durante o runtime.

As ações podem gerar uma resposta contextual à consulta de um usuário usando os resultados da ação. Você também pode criar explicitamente uma resposta para a ação.

Adicionar uma ação

1. Abra o copiloto personalizado escolhendo Copilotos no painel de navegação no lado esquerdo e selecionando o copiloto na lista.

2. Selecione Ações para exibir ações do copiloto.

3. Selecione + Adicionar uma ação.

4. No assistente Escolha uma ação (versão preliminar), procure uma ação que você deseja usar e a selecione.

   A lista padrão mostrada tem Fluxos e conectores personalizados do Power Automate disponíveis dentro do ambiente. Essa lista também inclui conectores predefinidos normalmente usados e Habilidades do Bot Framework registradas com o copiloto.

   

   Importante

   Algumas ações criadas a partir de plug-ins de IA, como solicitações dinâmicas e aquelas baseadas em APIs do Dataverse, exigem autenticação.

   

   Dependendo da ação, a conexão é configurada automaticamente, conforme mostrado no exemplo. Alternativamente, você será solicitado a configurar a conexão se as instruções forem fornecidas no assistente. Depois que a conexão for configurada com êxito, selecione Avançar.

   

5. Revise e, se necessário, faça alterações para sua configuração das ações de plug-in. Selecione Concluir para adicionar a ação ao copiloto.

   Selecione Avançar.

Chamar uma ação

Se você tiver habilitado ações generativas, a ação será chamada automaticamente em resposta a uma consulta do usuário relevante.

Você também pode chamar explicitamente uma ação de dentro de um tópico.

Testar sua ação

Chamada de uma ação

O copiloto seleciona e executa a ação com base no nome e na descrição. Você pode criar descrições de alta qualidade usando o modo de rastreamento dedicado para ver quais ações o copiloto selecionou na página ações generativas.

Como alternativa, se tiver adicionado um tópico, você poderá testá-lo inserindo uma mensagem semelhante a uma das frases de gatilho para esse tópico.

Você pode ver uma ação climática sendo testada nesta captura de tela:

Como alternativa, se tiver adicionado uma ação a um tópico, você poderá testar disparando o tópico com uma frase de gatilho indicada.

Configuração de entradas e saídas para uma ação

Fazer alterações na configuração de ação

Existem muitas maneiras de configurar a ação. Na etapa final do assistente de ação, chamada Revisar e Concluir, você pode fazer alterações na configuração da ação clicando em Editar ao lado da seção indicada.

Detalhes da ação

Aqui você pode configurar detalhes sobre a ação, inclusive o Nome de exibição do modelo e Descrição do modelo para a ação. Normalmente, o nome e a descrição são pré-populados para você com base na ação selecionada.

As propriedades Nome de exibição e Descrição de cada entrada ajudam o copiloto a compreender a finalidade da entrada, a gerar uma pergunta indicada para o usuário e a reconhecer o valor correto na resposta de um usuário. Por exemplo, estes são o nome padrão e a descrição do parâmetro de entrada da localização do conector MSN Clima.

• Nome: Local
• Descrição: a consulta de pesquisa do local. As entradas válidas são Cidade, Região, Estado, País/Região, Ponto de Referência, CEP, latitude e longitude

Ao solicitar um local para o usuário, o copiloto gera uma pergunta semelhante a: Para qual local onde você gostaria de verificar o clima? Você pode inserir cidade, região, estado, país/região, ponto de referência ou código postal.

Você também pode alterar a opção Identificar como para um tipo de entidade específico, dependendo da entrada que está sendo coletada, o que pode ajudar o copiloto a extrair com precisão um valor da resposta de um usuário.

Por padrão, cada entrada é definida como Preencher dinamicamente com a melhor opção. O copiloto tenta preencher o valor do contexto disponível, como extrair um valor da mensagem do usuário. Se nenhum valor indicado for encontrado, uma pergunta será gerada para solicitar um valor ao usuário. Você pode substituir uma entrada por um valor, em vez de perguntar ao usuário. Para substituir, altere o menu suspenso Como o copiloto vai preencher a entrada? para Definir como um valor e insira um valor. Esse valor pode ser literal, uma variável existente ou uma fórmula do Power Fx.

Para controlar o comportamento do copiloto ao solicitar um valor ou validar a resposta de um usuário, você pode configurar configurações adicionais para entradas.

Saídas

Por padrão, a ação é configurada a fim de gerar automaticamente uma resposta contextual para um usuário, com base na consulta e no resultado da ação. Por exemplo, se um usuário pergunta "Qual é a temperatura em Londres agora?", uma resposta contextual é gerada usando o GPT, como "A temperatura em Londres agora é de 9 graus Celsius."

Você também pode optar por criar uma resposta específica para que a ação retorne. Assim como acontece com o editor de confirmação, você pode inserir referências a variáveis de saída da ação usando o seletor de variáveis, como a mostrada nesse exemplo.

Chamar ação de dentro de um tópico

Você pode chamar explicitamente uma ação de dentro de um tópico, semelhante à chamada de outros tipos de ação, como fluxos do Power Automate. Dependendo do seu caso de uso, você pode usar seu Flow como parte de um tópico mais amplo, que usa mais nós. Ou, como no exemplo do clima, basta adicionar um único nó de ação a um tópico.

Para chamar uma ação de dentro de um tópico:

1. No Copilot Studio, acesse a página Tópicos do copiloto que você deseja editar.

2. Crie um novo tópico e nomeie-o como Obter clima.

3. Adicione as seguintes Frases de gatilho:

   • vai chover
   • previsão de hoje
   • obter clima
   • como está o clima

   

4. Selecione Adicionar nó (+) e depois Chamar uma ação. Mude para a guia Ações de plug-in (versão preliminar) e selecione a ação que você criou anteriormente, Obter previsão do tempo.

   

5. O nó Ação do plug-in (versão preliminar) já está adicionado ao tópico.

   

6. Selecione Salvar.

Substituir entradas ao chamar uma ação de um tópico

Por padrão, quando a ação é executada, o copiloto gera perguntas para o usuário popular as entradas necessárias. No entanto, em alguns casos, convém substituir uma ou mais entradas e fornecer um valor explícito, em vez de perguntar ao usuário. Você pode substituir na configuração da ação do plug-in dentro da seção Entradas. Ou só convém substituir valores quando a ação é usada em um tópico específico:

1. Selecione Definir valor no nó e escolha a entrada que deseja substituir.

   

2. Insira o valor da entrada digitando um valor, selecionando uma variável ou usando uma fórmula.

   

Agora que essa entrada foi substituída, o copiloto não vai solicitar um valor ao usuário.

Habilitar autenticação para ações de IA

Algumas ações, quando criadas com base em ações de IA, exigem autenticação para funcionar corretamente, como Solicitação dinâmica ou outras que chamam uma API do Dataverse.

As ações são sempre executadas em runtime do Microsoft Copilot no contexto do usuário final e não podem ser executadas, a menos que a autenticação esteja habilitada. Dois tipos de métodos de autenticação são suportados:

1. Vá até as propriedades de ação do conector.

2. Em Autenticação do usuário final, selecione Autenticação do autor do Copilot.

3. Publique e teste a experiência no painel de teste do copiloto ou em um canal desejado.

   

Usar ações de fluxo com credenciais de usuário final

As ações de fluxo podem ser configuradas para usar credenciais de usuário final. Se você usar o fluxo em um canal compatível, isso não exigirá uma configuração especial na caixa de diálogo do copiloto, e os usuários finais poderão gerenciar as conexões por um fluxo indicado em uma experiência fornecida.

Autenticação para ações com base em plug-ins na biblioteca

Quando criadas com base em plug-ins de IA, as ações exigem autenticação para funcionarem corretamente. Isso costuma ser mais visto com ações com base em solicitações ou outras que chamem APIs do Dataverse. As ações baseadas em plug-ins são sempre executadas no contexto do usuário final e não podem ser executadas, a menos que a autenticação esteja habilitada. Dois tipos de métodos de autenticação são suportados:

• Autenticação integrada (Teams e Power Apps): você poderá usar esse método de autenticação se quiser publicar o copiloto em um canal do Teams. Esse método também funciona para copilotos inseridos em qualquer aplicativo Power Platform que use tokens compilados com o padrão PPAPI.

• Autenticação manual (copilotos de terceiros): este método de autenticação envolve a configuração de uma conexão de ID do Microsoft Entra.

Para criar uma conexão de autenticação manual:

1. Configurar um aplicativo da ID do Microsoft Entra.

2. Configure a autenticação manual para o copiloto do Copilot Studio.

3. Permita que seu aplicativo use a delegação para buscar um token em nome do usuário. Certifique-se de adicionar todos os escopos necessários.