Use 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 seu agente para responder aos usuários automaticamente, usando orquestração generativa, ou você pode chamá-las explicitamente de dentro de um tópico.
Tipos de ação básica
Se você ativar a orquestração generativa, seu agente pode automaticamente Select selecionar a ação mais apropriada ou tópico, 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 projetar seu agente para chamar ações explicitamente de dentro de 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 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. 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 manipuladas para você em tempo de execução.
Por padrão, ao usar o modo generativo, as ações retornam suas informações para o agente, para que o agente possa gerar um resposta contextual para a consulta do usuário. Como alternativa, você pode instruir sua ação para 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.
Select Ações para visualizar ações para agente.
Selecione Adicionar uma ação.
No assistente Escolher uma ação , procure uma ação que você deseja usar e Select.
A lista padrão mostrada tem Fluxos e conectores personalizados do Power Automate disponíveis dentro do ambiente. Esta lista inclui conectores pré-construídos comumente usados e Bot Framework habilidades 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 sua configuração ação do plug-in e faça alterações se necessário.
Selecione Avançar.
Select Concluir para adicionar a ação ao seu agente.
Testar sua ação
Se você habilitou a orquestração generativa, sua ação será chamada automaticamente em resposta para uma consulta de usuário relevante.
Alternativamente, você pode chamar uma ação explicitamente de dentro de um tópico.
Seu agente seleciona e executa sua ação com base no nome e na descrição. Você pode autor descrições de alta qualidade, usando o mapa de atividades para ver quais ações seu 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 seu 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 de exibição e Descrição para cada entrada ajudam o agente a entender o propósito da entrada, a gerar uma pergunta apropriada para o usuário e a reconhecer o valor correto no 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 clima? 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 a extrair com precisão um valor do 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á esta entrada?, Select 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 seu agente 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 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:
Em Copilot Studio, vá para a página Tópicos do agente que você deseja 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 tempo
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 foi substituída, o agente não solicita 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 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:
Vá até as propriedades de ação do conector.
Em Autenticação do usuário final, autenticação Select agente autor.
Publique e teste a experiência no painel de teste agente 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. Usar um fluxo em um canal compatível não requer nenhuma configuração especial na caixa de diálogo agente, e os usuários podem gerenciar suas conexões para um determinado fluxo 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. Ações baseadas em plugins 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 este método de autenticação se quiser publicar seu agente em um canal do Teams. Este método também funciona para agentes incorporados em qualquer Power Platform aplicativo que usa tokens criados com o padrão PPAPI.
Autenticação manual (agentes de terceiros) :Este método de autenticação envolve a configuração de um Microsoft Entra Conexão de ID.
Para criar uma conexão de autenticação manual:
Configurar um aplicativo da ID do Microsoft Entra.
Configure autenticação manual para seu 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.
