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 efetuar login em Copilot Studio, você tem permissão para acessar agentes específicos 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 deseja estender, verifique suas credenciais. Tente também se conectar ao próprio agente ou tente autor quaisquer tarefas 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 aduaneiros
• Microsoft 365 Copilot e agentes Copilot
• Outros copilotos aos quais eles têm acesso de criador em sua organização

Select e agente podem ser estendidos selecionando Agentes no menu principal e, em seguida, escolhendo na lista de agentes personalizados e agentes Copilot.

Ver ações existentes para um agente

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

Para visualizar as ações existentes para um agente, Select, acesse a guia Ações na página 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:

• Personalizado agente: Select + Adicione uma ação.
• Agente do Copilot: Select + Adicionar ação.

Você pode então Select escolher um tipo de ação de uma lista de opções disponíveis para iniciar o processo de extensão do 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 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: autor a extensão para agente, que resulta na criação de uma ação.
• Teste: valide se a ação funciona com seu 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.
• Feedback: informe os usuários que eles estão prestes a fazer uma alteração nos dados e peça permissão antes de agir, forneça cartão para facilitar a exibição dos resultados, forneça exemplos de perguntas que os usuários podem fazer com agente.
• Identidade visual: forneça ícones e informações de identidade visual para sua ação para fins de distribuição.

Observação

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

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

Depois que uma ação é publicada, o administrador do agente precisa revisar e habilitar o plugin para uso. Quando um administrador habilita um agente, ele também deve 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. Depois de ativado, um plug-in aparece no ambiente onde foi criado. O plugin também pode ser exportado 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, ele aparece no catálogo de ações onde todos os usuários de 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

Estenda 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).

Estenda um agente do Copilot com uma ação

Copilot Studio fornece uma maneira rápida e fácil de guia uma ação usando um assistente passo a passo para guia você durante o processo.

Ele pode ser usado para estender agentes Copilot da marca Microsoft ou agentes personalizados. Depois de escolher o agente que você gostaria de estender, ele o guiará 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

Ações criadas em Copilot Studio podem ter diferentes componentes 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

Existem vários manipuladores de entrada e fontes de conteúdo disponíveis para servir como base para plug-ins. 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:

• Conversacional: Uma ação conversacional incorporada Microsoft Copilot Studio permite que você estenda o comportamento do seu agente. Você pode criar novas habilidades que não são nativas em 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 de 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. Conectores personalizados permitem que seu plug-in 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: Microsoft Power Automate fluxos de nuvem podem ser chamados 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 de um Microsoft 365 Copilot chat para executar ações ou recuperar informações no ambiente do usuário final.

• 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 todo tipo de ação está disponível 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 precisar segmentar o acesso a ações específicas, você deverá criar plug-ins diferentes com extensões diferentes em cada um, com direitos de acesso apropriados atribuídos a cada plug-in.

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 aprimorados 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 confirmação aos 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 o plug-in editando-o.

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 do plug-in 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 o plug-in. Gatilho fornece uma maneira alternativa de exibir resultados de uma consulta 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 um plug-in. 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 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 o novo plug-in dentro do Microsoft 365 fazendo sideload do plug-in. 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 do plug-in 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. Ela só está disponível para o autor validar se o plugin funciona conforme o esperado.

Use ações em Microsoft 365 Copilot

Os usuários finais em seu locatário podem usar ações de conversação e IA em seus bate-papos com 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.
• Seu Power Platform Cartões Adaptáveis habilitou o "Microsoft 365 Configuração Copilot" em Power Platform centro de administração
• O usuário final habilita a conexão de dentro do seu chat com 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. Select Implantar para habilitar o aplicativo em chats com 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 Microsoft 365 Copilot no Power Platform centro de administração (admin)

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 os plug-ins criados no Copilot Studio aparecerão para os 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 finais. Isso pode mudar no futuro.
• Observe que, como administrador, você ainda pode bloquear a exibição de plug-ins 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 para integração com Microsoft 365 Copilot em escala usando grupos de ambiente.

Habilitar a conexão no Microsoft Copilot

Microsoft 365 Copilot Os usuários finais precisam habilitar os plugins antes de usá-los no chat. Os plug-ins disponíveis podem ser ativados através do menu de plug-ins ou do portal de configuração de plug-ins do Power Platform.

Eles podem acessar o portal perguntando sobre plugins no chat com Microsoft 365 Copilot. Eles recebem um breve resumo sobre plug-ins 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 um plug-in?
• Fale sobre os plug-ins do Copilot 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 em Microsoft 365 Copilot pela pessoa que as criou.

No entanto, o autor da ação pode compartilhar seus plug-ins no portal onde os 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
Crie ações de conversação para Microsoft 365 Copilot	Amplie Microsoft 365 Copilot criando ações que podem responder à pergunta de um usuário com dados extras.
Estenda um agente do Copilot com ações rápidas (versão preliminar)	Amplie a agente do Copilot da marca Microsoft com uma ação rápida.
Estenda um agente do Copilot com ações de fluxo (versão preliminar)	Amplie a agente do Copilot da marca Microsoft criando uma ação de fluxo.
Estenda um agente do Copilot com ações de conector (versão preliminar)	Amplie a agente do Copilot da marca Microsoft criando uma ação de conector.
Estenda Microsoft 365 Copilot com agentes Copilot	Estenda Microsoft 365 Copilot com um agente do Copilot.
Use 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.