Visão geral dos conectores e ações do Copiloto (versão preliminar)

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

Como funciona

Ao entrar no Copilot Studio, ele determina quais agentes específicos você tem permissão para acessar, com base na licença associada às suas credenciais. A lista de agentes disponíveis para você depende dessas permissões. Se você não vir o agente que quer estender, verifique suas credenciais. Tente também se conectar ao próprio agente ou tente acionar quaisquer trabalhos que devem ocorrer para preparar o agente para uso. Consulte as seções que detalham a experiência de criação para obter exemplos.

Um criador começa selecionando o copiloto cuja funcionalidade ele deseja estender:

• Agentes personalizados
• Microsoft 365 Copilot e agentes do Copilot
• Outros copilotos aos quais eles têm acesso de criador em sua organização

Selecione um agente para estender, selecionando Agentes no menu principal e, em seguida, escolhendo na lista de agentes personalizados e agentes do Copilot.

Exibir ações existentes para um agente

Depois de selecionar um agente, você pode exibir as ações atualmente disponíveis para o agente no painel de configuração/criação do agente.

Para exibir as ações existentes para um agente, selecione a guia Ações na página do agente.

A lista de ações disponíveis será exibida.

Criação da própria ação nova

Você também pode criar suas próprias ações novas.

As etapas dependem do tipo de agente:

• Agente personalizado: selecione + Adicionar uma ação.
• Agente do Copilot: selecione + Adicionar ação.

Em seguida, você pode selecionar um tipo de ação em uma lista de opções disponíveis para iniciar o processo de estender o agente com mais recursos.

O Copilot Studio orienta você nas etapas de configuração. Os detalhes das etapas dependem se você está estendendo um agente personalizado ou uma agente do Copilot.

As etapas de configuração detalhadas são abordadas posteriormente na documentação. Após a conclusão, o usuário pode publicar a ação para o agente. Essa ação está pronta para ser analisada e aprovada por um administrador. Depois de aprovada, a ação fica disponível para todos os usuários que tiverem permissão de uso, dentro daquela organização específica.

O Copilot Studio oferece várias maneiras de tornar o processo de extensão fácil e abrangente, incluindo:

• Criação: crie a extensão para o agente, que resulta na criação de uma ação.
• Teste: valide se a ação funciona com o agente, testando-a durante ou após o processo de publicação.
• Edição: salve rascunhos de ações em andamento ou edite ações e publique os resultados para uso.
• Exportação/importação: execute ações concluídas existentes e distribua-as para outras organizações dentro de sua empresa ou para seus próprios clientes se você for um ISV. Você também pode exportar o pacote a ser enviado para certificação com a Microsoft para disponibilizar sua ação no catálogo online.
• Comentários: informe aos usuários que eles estão prestes a fazer uma alteração nos dados e peça permissão antes de executar uma ação, forneça um cartão para facilitar a exibição dos resultados, forneça exemplos de perguntas que os usuários possam fazer ao agente.
• Identidade visual: forneça ícones e informações de identidade visual para sua ação para fins de distribuição.

Observação

O Microsoft 365 Copilot também pode ser estendido com agentes do Copilot.

O que acontece depois de publicar sua ação?

Após a publicação de uma ação, o administrador do agente precisa revisar e habilitar a ação para uso. Quando um administrador habilita um agente, ele também precisa determinar quais grupos de usuários têm permissão para usá-lo. O local para gerenciar permissões pode ser diferente, dependendo do agente. Mais informações estão disponíveis na documentação de administração. Uma vez ativada, uma ação é exibida no ambiente onde foi criada. A ação também pode ser exportada para uso em outros agentes. A exportação cria um pacote que pode ser implantado em outros ambientes. Portanto, você não precisa recriar a ação para cada ambiente em que deseja usá-la.

Mais informações sobre a importação e exportação de ações estão disponíveis em Soluções de exportação.

As ações publicadas também podem ser enviados à Microsoft para certificação. A certificação é feita usando o Partner Center e envolve uma revisão da ação e a certificação pela Microsoft. Depois disso, ela aparece no catálogo de ações onde todos os usuários do Copilot Studio podem usar para estender seus agentes também.

Para obter mais informações sobre certificação, consulte a seguinte documentação.

• Processo de certificação de editor verificado
• Enviar seu conector para certificação da Microsoft

Estender um agente personalizado com uma ação

Para estender um agente personalizado com uma ação, consulte Usar ações com agentes personalizados (versão preliminar).

Estender um agente do Copilot com uma ação

O Copilot Studio fornece uma maneira rápida e fácil de criar uma ação usando um assistente passo a passo para guiá-lo pelo processo.

Ele pode ser usado para estender agentes do Copilot da marca Microsoft ou agentes personalizados. Depois de escolher o agente que você deseja estender, ele orienta você por uma série de etapas para criar a ação.

O assistente solicitará que você:

• Escolha o tipo de manipulador/origem que você deseja usar
• Forneça informações de autenticação, se necessário, para o tipo de manipulador/origem escolhido
• Selecione as ações de componente que você deseja incluir na ação
• Defina parâmetros de entrada e de saída para cada ação de componente
• Proporcionar outras experiências aprimoradas, como:
  • Caixa de diálogo de consentimento do usuário
  • Cartões adaptáveis para exibir seus resultados e perguntas iniciais de conversa
  • Informações de identidade visual para certificação

Depois de concluir essas etapas, você poderá publicar a ação. Um administrador pode então revisar sua ação in e ativá-la. Depois que a ação é ativada, você pode usá-la em sua organização, implantá-la em outras organizações ou enviá-la à Microsoft para certificação, a fim de disponibilizá-la ao público em geral.

Componentes de uma ação

As ações criadas no Copilot Studio podem ter componentes diferentes que são reunidos para criar a ação para uso em agentes.

• Manipuladores e fontes de conteúdo
• Autenticação
• Ações de componente
• Entradas e saídas
• Recursos aprimorados (consentimento do usuário, iniciadores de conversa, cartões adaptáveis, identidade visual, gerenciamento de soluções)

Manipuladores e fontes de conteúdo - tipos de ação

Há vários manipuladores de entrada e fontes de conteúdo disponíveis para servir como base para ações. No Copilot Studio, essas fontes são chamadas de ações. O que esses diferentes tipos de ações têm em comum é a estrutura básica de comunicação com os detalhes da fonte ao enviar consultas. Os seguintes tipos de ações estão disponíveis:

• Conversa: uma ação de conversa interna do Microsoft Copilot Studio permite que você estenda o comportamento do seu agente. Você pode criar novas habilidades que não são possíveis de modo natural no Microsoft 365 Copilot, como chamar uma API específica, aplicar lógica de negócios sofisticada ou acessar fontes de dados que exigem configuração fora do acesso ao Microsoft 365 Copilot. Essas capacidades são configuradas de forma semelhante a um tópico padrão criado no Copilot Studio.

• Conectores: as ações do conector são usadas no Microsoft Dataverse para se conectar a outras fontes de dados. Quando criado, o conector inclui componentes específicos que podem ser usados com o conector. É possível usar conectores certificados pela Microsoft ou conectores personalizados criados dentro de uma organização ou locatário. Os conectores personalizados permitem que sua ação recupere e atualize dados de fontes externas acessadas por meio de APIs. Os conectores possibilitam o acesso a dados de sistemas corporativos populares, como Salesforce, Zendesk MailChimp e GitHub. Os conectores são usados rotineiramente pelos fabricantes em seus Power Apps e fluxos.

• Fluxos: os fluxos da nuvem do Microsoft Power Automate podem ser chamados a partir de um agente para executar ações, recuperar informações e automatizar processos em outros aplicativos e fontes de dados usando conectores. Os fluxos podem ser chamados de dentro do chat do Microsoft 365 Copilot para executar ações ou recuperar informações no ambiente do usuário.

• Prompts: são modelos de prompt de IA criados para personalizar a geração de conteúdo de texto em relação à entrada do usuário. Esses modelos podem ser usados para vários cenários, como resumo, itens de ação, extração de sentimento ou entidade, tradução de texto e muito mais. Além disso, você pode adicionar seus próprios dados do Dataverse para aumentar as fontes de conhecimento e obter respostas específicas de negócios. Os prompts permitem que seus usuários usem uma linguagem simples e natural para obter respostas e executar ações com o Microsoft Copilot. Eles usam a compreensão de linguagem natural (NLU) para entender a intenção de um usuário e mapeá-la para uma informação, dado ou atividade associada.

Nem todos os tipos de ação estão disponíveis para todos os agente do Copilot da marca Microsoft:

Recurso	Microsoft 365 Copilot	Microsoft 365 Copilot para Vendas	Microsoft 365 Copilot para Serviços
Conversacional	Disponível	Não disponível	Não disponível
Connector	Disponível	Disponível	Disponível
Solicitar	Disponível	Não disponível	Disponível
Fluxo	Disponível	Não disponível	Não disponível

Você cria e configura ações no Copilot Studio. Também é possível criar e editar alguns tipos de ações no Power Apps. Saiba mais em Criar um prompt (versão preliminar) no Power Automate ou no Power Apps.

Autenticação

Para usar as fontes de conteúdo, você precisa definir a autenticação da fonte. As fontes exigem tipos específicos de autenticação. Quando você seleciona seu conteúdo, a fonte fornece as solicitações necessárias para autenticação.

Veja alguns exemplos:

• Sem autenticação: conector do MSN Weather. Essa ação do conector recupera apenas dados meteorológicos públicos e não tem conteúdo seguro. Como resultado, o conector meteorológico está aberto para ser usado sem fornecer credenciais.
• Ações de fluxo: os fluxos da nuvem usam as configurações de conexão e conexão definidas no momento da criação.
• Ações do conector: se você usar um conector para acessar uma fonte de dados, ele terá seu método de autenticação integrado ao conector. Você não precisa configurá-lo, mas é necessário fornecer credenciais antes de testar ou usar a conexão.
• Ação imediata: usa sua identidade do Teams ou do Power Apps. Certifique-se de compartilhar a solicitação com os usuários ou grupos apropriados.
• Ações de conversa: as ações de conversa não precisam de autenticação própria. No entanto, uma ação de conversa pode ser usada para chamar uma ação do conector, caso em que o mecanismo de autenticação do conector é invocado.

Cada origem tem ações de componente já definidas, mas ao configurar, você pode selecionar as ações de componente que deseja usar. Você pode selecionar qualquer número das ações de componente para usar com a origem. Por exemplo, com uma fonte de conteúdo indicada, você pode executar as seguintes ações:

• Recuperar uma lista de usuários
• Adicionar um novo usuário
• Atualizar os detalhes de um usuário
• Excluir um usuário

Desde que essas ações estejam presentes na origem, o manipulador pode executar qualquer uma das ações.

Observação

Cada ação de componente está disponível para os usuários da ação. Você não pode ter permissões baseadas em função para uma ação específica nele. Por exemplo, se você tivesse uma extensão de gerenciamento de ordem que permitisse recuperar uma lista de registros, atualizar uma ordem, criar uma ordem e cancelar uma ordem, todos os usuários com permissões para essa extensão poderiam realizar qualquer uma dessas ações. Se você precisar segmentar o acesso a ações específicas, será necessário criar extensões diferentes com ações diferentes em cada uma delas, com as funções de segurança apropriadas atribuídas a cada ação.

Entradas e saídas

As entradas e saídas são específicas para uma ação e fornecem todas as opções de entrada de dados possíveis para uma ação e definem os resultados a serem retornados. Esses parâmetros são fornecidos pela fonte de conteúdo (conectores, API REST etc.) e não podem ser adicionados ou removidos. No entanto, as descrições podem ser atualizadas para fornecer um melhor entendimento das entradas e saídas. Eles são mostrados como parte da configuração para fornecer visibilidade sobre o que precisa ser incluído em uma consulta e o que é retornado.

Recursos aprimorados

Recursos aprimorados estão disponíveis ao configurar extensões para alguns tipos de agente.

Os recursos aprimorados incluem:

• Soluções
• Consentimento do usuário
• Temas de conversa
• Cartões Adaptáveis
• Testes

Nem todos os recursos avançados estão disponíveis em todos os tipos de agente.

Soluções

As soluções são essenciais para o gerenciamento do ciclo de vida de aplicativos. Se salva em uma solução, uma ação pode ser facilmente movida entre ambientes. Por padrão, o sistema seleciona a solução mais adequada para você, com base na solução preferida ou em uma solução na qual os componentes do conector estejam presentes. Você também pode alterar a solução. Se você não especificar uma solução para a ação, o sistema vai criar automaticamente uma solução no tempo de execução.

Saiba mais sobre soluções em Noções básicas de gerenciamento do ciclo de vida do aplicativo (ALM) com o Microsoft Power Platform.

Consentimento do usuário

Ative o consentimento do usuário para uma ação se quiser que o agente solicite a confirmação dos usuários antes de executar uma ação. Essa opção ajuda a evitar ações não intencionais que podem afetar os dados.

Práticas recomendadas:

• Para ações somente de recuperação de dados (obter, recuperar, listar e assim por diante), desative o consentimento do usuário. Essas ações apenas recuperam um conjunto de dados e o exibem. Eles não colocam os dados em risco.
• Para outras ações (criar, atualizar, excluir, adicionar, remover e assim por diante), ative o consentimento do usuário. Essas ações podem adicionar ou alterar dados no sistema, portanto, é uma boa ideia solicitar que os usuários confirmem antes de executar uma ação. Você sempre pode alterar as configurações de consentimento do usuário para a ação, editando-a.

Temas de conversa

O iniciador de conversa permite criar perguntas comumente usadas que são exibidas como botões clicáveis. Os iniciadores de conversa executam a consulta imediatamente. Eles também mostram tipos de consultas que podem ser usados. Esses exemplos podem ajudar os usuários a criar mais consultas por conta própria usando o enquadramento de linguagem natural bem-sucedido. Os iniciadores de conversa são definidos no nível de ação e são opcionais. Você pode editá-los a qualquer momento.

Cartões Adaptáveis

Os cartões adaptáveis são um componente opcional configurado no nível de ação. Você pode adicioná-los ou modificá-los a qualquer momento editando a ação. Os cartões adaptáveis fornecem uma maneira alternativa de exibir os resultados de uma consulta do agente.

Os cartões adaptáveis vêm em dois tipos:

• Padrão: um cartão adaptável básico que pode ter um título, um subtítulo, um corpo e um botão que leva o usuário a um local de URL. Ele fornece uma exibição mais estilizada e uma chamada para ação.
• Personalizado: os cartões adaptáveis personalizados são criados fora do assistente e podem ser carregados para inclusão em uma ação. Esses cartões são mais personalizáveis e podem ter vários campos, vários botões e outras opções. Você pode criar um cartão personalizado no Designer de Cartões Adaptáveis e exportá-lo como um arquivo para upload.

Ao configurar o cartão adaptável padrão, você deve selecionar um caminho raiz. O caminho raiz é um segmento do arquivo de configuração do fonte de dados e inclui todos os campos que podem ser selecionados para definir o título ou corpo. Pode haver vários caminhos raiz em um arquivo de origem e todos os caminhos disponíveis estão disponíveis para seleção. Depois de selecionar um caminho raiz, você pode escolher o título e o corpo desejados nas listas.

Cada cartão adaptável mostra os valores retornados e, em seguida, lista as referências usadas ao compilar o resultado. Os cartões adaptáveis também permitem que um usuário especifique o layout de exibição de referência. Esse layout mostra as referências usadas na consulta para obter mais informações. Ele pode mostrar um título, uma URL e um subtítulo. Também há listas suspensas que podem ser preenchidas com base na seleção do caminho raiz.

Observação

Ao carregar um modelo de cartão adaptável personalizado, nenhum recurso de edição é fornecido no assistente, pois o cartão personalizado já deve incluir todos os campos, botões e valores mapeados a serem consumidos pelo agente. Qualquer campo deixado em branco no modelo Padrão não aparece no cartão adaptável dentro do agente.

Testes

Para ações do conector, um criador pode testar a nova ação dentro do Microsoft 365 fazendo sideload da ação. Essa opção aparece na tela de revisão da ação. Ela solicita que o usuário selecione ou crie uma conexão e, em seguida, cria uma versão de teste com sideload da ação disponível no ambiente do Microsoft 365. Essa versão de teste não está visível externamente e não é publicada para aprovação do administrador. Somente está disponível para o autor validar se a ação funciona conforme o esperado.

Usar ações no Microsoft 365 Copilot

Os usuários em seu locatário podem usar ações de conversa e IA em seus chats com o Microsoft 365 Copilot se:

• Seu administrador de locatário do Microsoft 365 implanta o aplicativo Copilot Studio no centro de administração do Microsoft 365.
• O administrador de ambiente do Power Platform habilitou a configuração do "Microsoft 365 Copilot" no centro de administração do Power Platform
• O usuário habilita a conexão de dentro de seu chat com o Microsoft 365 Copilot.

Implantar o aplicativo Copilot Studio no centro de administração do Microsoft 365 (administrador)

1. Entre no centro de administração do Microsoft 365 com sua conta do administrador.
2. Expanda Configurações no painel de navegação lateral e selecione Aplicativos integrados.
3. Acesse a guia Aplicativos disponíveis e selecione a entrada Microsoft Copilot Studio. O painel de detalhes do aplicativo é aberto.
4. Selecione Implantar para habilitar o aplicativo em chats com o Microsoft 365 Copilot.

Os administradores de locatários podem habilitar ou desabilitar:

• Mostrando ações de IA/tópico conversacional e ações de Prompt no aplicativo Microsoft 365 Chat usando o aplicativo "Copilot Studio".
• Mostrando Ações de fluxo no aplicativo Microsoft 365 Chat usando o aplicativo "Power Automate".
• Ações do conector e ações da API no aplicativo Microsoft 365 Chat usando os aplicativos associados (o nome do aplicativo será o conector ou o nome da ação). Além disso, ações de conector personalizadas estão disponíveis na loja do Teams para os usuários instalarem.

Habilitar ou Desabilitar o Microsoft 365 Copilot no centro de administração do Power Platform (administrador)

1. Vá até o centro de administração do Power Platform usando a conta do administrador.
2. Vá até Ambientes e selecione o ambiente da lista.
3. Selecione Configurações.
4. Em Produto, selecione Recursos
5. Encontre a configuração do Microsoft 365 Copilot e ative (ou desative) para permitir a integração de agentes do Copilot a partir desse ambiente.
6. Role para baixo e selecione Salvar.

Importante

Nesta versão, há algumas limitações:

• A integração com o Copilot Studio e o Power Automate é ativada por padrão. Isso significa que as ações criadas no Copilot Studio serão mostradas aos usuários no "Copilot Studio" ou no "Power Automate", mesmo que os administradores do locatário não tenham implantado explicitamente o aplicativo para os usuários. Isso pode mudar no futuro.
• Observe que, como administrador, você ainda pode bloquear a exibição de ações para seus usuários bloqueando o aplicativo no Centro de Administração do Microsoft 365.
• No futuro, os clientes poderão gerenciar a configuração de integração com Microsoft 365 Copilot, em escala, usando Grupos de ambiente.

Habilitar a conexão no Microsoft Copilot

Os usuários do Microsoft 365 Copilot precisam ativar ações antes de usá-las no chat. As ações disponíveis podem ser habilitadas por meio do menu de ações ou do portal de configuração de ações do Power Platform.

Eles podem acessar o portal perguntando sobre ações em seu chat com o Microsoft 365 Copilot. Eles recebem um pequeno resumo sobre as ações e um link para o portal:

Os usuários também podem fazer perguntas direcionadas sobre conexões de dados ou como realizar tarefas interorganizacionais, por exemplo, eles podem perguntar:

• Como posso usar uma ação?
• Fale sobre as ações do Copilot do Copiloto do Power Platform
• Como posso obter dados de um sistema externo?
• Como posso obter dados do Salesforce?

Ações de compartilhamento

Por padrão, as ações só são visíveis e utilizáveis no Microsoft 365 Copilot pela pessoa que as criou.

No entanto, o autor da ação pode compartilhar suas ações no portal onde as criou. Por exemplo, você pode compartilhar um prompt do AI Builder da página Prompts de IA selecionando Compartilhar do prompt. O mesmo se aplica aos fluxos do Power Automate (da página Fluxos no Power Automate) ou a conectores personalizados da página Conectores personalizados.

Conteúdo relacionado

Artigo	Description
Criar ações de conversa para o Microsoft 365 Copilot	Estenda Microsoft 365 Copilot criando ações que podem responder à pergunta de um usuário com dados extras.
Estender um agente do Copilot com ações de prompt (versão preliminar)	Estenda um agente do Copilot da marca Microsoft com uma ação de prompt.
Estender um agente do Copilot com ações de fluxo (versão preliminar)	Estenda um Agente do Copilot da marca Microsoft criando uma ação de fluxo.
Estender um agente do Copilot com ações do conector (versão preliminar)	Estenda um Agente do Copilot da marca Microsoft criando uma ação do conector.
Estender o Microsoft 365 Copilot com agentes do Copilot	Estender o Microsoft 365 Copilot com um agente do Copilot.
Usar ações com agentes personalizados (versão preliminar)	Estenda um copiloto personalizado criando tópicos complexos para usar em copilotos que você cria no Copilot Studio, sem fazer nada complexo.