Usar ações com agentes personalizados (versão preliminar)
Você pode estender os recursos do seu agente adicionando uma ou mais ações. As ações são usadas pelo agente para responder automaticamente aos usuários usando orquestração generativa, ou você pode chamá-las explicitamente dentro de um tópico.
Tipos de ação básica
Se você ativar a orquestração, o agente pode selecionar automaticamente a ação ou o tópico mais apropriado, ou pesquisar no conhecimento, para responder a um usuário.
No modo clássico (orquestração generativa desabilitada), um agente só pode usar tópicos para responder ao usuário. No entanto, você ainda pode criar seu agente para chamar ações explicitamente de 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
- AI Builder prompts (dentro de um tópico)
- Habilidade do Bot Framework
- Conexão de API REST
Cada ação principal tem informações adicionais que descrevem sua finalidade, permitindo que o agente use IA generativa para gerar perguntas. Essas perguntas são necessárias para preencher as entradas necessárias para executar a ação. Portanto, não é necessário criar nós de pergunta manualmente para reunir todas as entradas necessárias, como as entradas em um fluxo. As entradas são tratadas para você no runtime.
Por padrão, ao usar o modo generativo, as ações retornam suas informações para o agente, para que o agente possa gerar uma resposta contextual à consulta do usuário. Como alternativa, você pode instruir sua ação a sempre responder imediatamente, gerando uma mensagem ou criando uma mensagem explícita.
Dica
Ao usar perguntas geradas a partir de uma ação, informe os usuários de que parte da conversa é gerada por IA.
Por exemplo, adicione uma mensagem extra no tópico do sistemaInício de Conversa. Este tópico determina a mensagem mostrada aos usuários quando uma nova conversa é iniciada.
Adicionar uma ação
Abra seu agente escolhendo Agentes no painel de navegação esquerdo e selecionando seu agente na lista.
Selecione Ações para exibir ações para o agente.
Selecione Adicionar uma ação.
No assistente Escolher uma ação , procure uma ação que deseja usar e selecione-a.
A lista padrão mostrada tem Fluxos e conectores personalizados do Power Automate disponíveis dentro do ambiente. Esta lista inclui conectores Bot Framework e Habilidades pré-criados comumente usados que são registrados com seu agente.
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. Caso contrário, siga as instruções do assistente para configurar a conexão. Depois que a conexão for configurada com êxito, selecione Avançar.
Revise a configuração da ação do plug-in e faça alterações , se necessário.
Selecione Avançar.
Selecione Concluir para adicionar a ação ao agente.
Testar sua ação
Se você tiver habilitado orquestração generativa, 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.
Seu agente seleciona e executa sua ação com base no nome e na descrição. Você pode criar descrições de alta qualidade usando o mapa de atividade dedicado para ver quais ações o agente selecionou na página ações.
Você pode ver uma ação climática sendo testada nesta captura de tela:
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. Na tela Revisar entradas e saídas do assistente ou na página de detalhes de uma ação que já faz parte do agente, você pode gerenciar os parâmetros de entrada e saída da ação.
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 para exibição e Descrição para cada entrada ajudam o agente a entender a finalidade da entrada, a gerar uma pergunta apropriada 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
Quando o agente solicita ao usuário um local, ele gera uma pergunta como Qual é o local para o qual você gostaria de verificar o tempo? Você pode inserir uma cidade, região, estado, país/região, ponto de referência ou código postal.
Você 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 agente extrair com precisão um valor da resposta de um usuário.
Entradas
Por padrão, cada entrada é definida como Preencher dinamicamente com a melhor opção. O agente tenta extrair o valor do contexto disponível, por exemplo, 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 definir uma substituição, em Como o agente preencherá essa entrada?, selecione Definir como um valor e insira o valor desejado. Esse valor pode ser literal, uma variável existente ou uma fórmula do Power Fx.
Para controlar o comportamento do agente ao solicitar um valor ou validar a resposta de um usuário, você pode definir 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 uma 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:
No Copilot Studio, acesse a página Tópicos do agente que você quer editar.
Crie um novo tópico e nomeie-o como Obter clima.
Adicione as seguintes Frases de gatilho:
- vai chover
- previsão de hoje
- obter clima
- como está o clima
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.
O nó Ação do plug-in (versão preliminar) já está adicionado ao tópico.
Selecione Salvar.
Substituir entradas ao chamar uma ação de um tópico
Por padrão, quando sua ação é executada, seu agente gera perguntas para o usuário preencher 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:
Selecione Definir valor no nó e escolha a entrada que deseja substituir.
Insira o valor da entrada digitando um valor, selecionando uma variável ou usando uma fórmula.
Agora que essa entrada é substituída, o agente não pede 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 no tempo de execução do agente no contexto do usuário 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:
Vá até as propriedades de ação do conector.
Em Autenticação do usuário final, selecione Autenticação do autor do agente.
Publique e teste a experiência no painel de teste do agente ou em um canal desejado.
Usar ações de fluxo com credenciais de usuário
As ações de fluxo podem ser configuradas para usar credenciais de usuário. Usando um fluxo em um canal compatível, isso não exigirá uma configuração especial na caixa de diálogo do agente, 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 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ê pode usar esse método de autenticação se quiser publicar seu agente em um canal do Teams. Esse método também funciona para agentes incorporados em qualquer Power Platform aplicativo que use tokens criados com o padrão PPAPI.
Autenticação manual (agentes de terceiros): esse método de autenticação envolve a configuração de uma Microsoft Entra conexão de ID.
Para criar uma conexão de autenticação manual:
Configurar um aplicativo da ID do Microsoft Entra.
Configurar autenticação manual para o agente
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.
