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

Quando entra no Copilot Studio, ele determina quais copilotos você tem permissão para acessar, com base na licença associada às suas credenciais. A lista de copilotos disponíveis para você depende dessas permissões. Se você não vir o copiloto que deseja estender, verifique suas credenciais. Além disso, tente se conectar ao próprio copiloto ou tente acionar trabalhos que devem ocorrer para preparar o copiloto 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:

• Copilotos personalizados
• Copilotos criados pela Microsoft
• Outros copilotos aos quais eles têm acesso de criador em sua organização

Selecione um copiloto para estender selecionando Copilotos no menu principal e escolhendo na lista de copilotos personalizados e Microsoft Copilots.

Exibir ações existentes para um copiloto

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

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

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 copiloto:

• Copiloto personalizado: selecione + Adicionar uma ação.
• Microsoft Copilot: selecione + Adicionar Ação.

Você pode então selecionar um tipo de ação em uma lista de opções disponíveis para iniciar o processo de extensão do copiloto com mais recursos.

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

As etapas de configuração detalhadas são abordadas posteriormente na documentação. Após a conclusão, o usuário poderá publicar a ação para o copiloto. 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: criar a extensão para o copiloto, que resulta na criação de uma ação.
• Teste: valide se a ação funciona com o copiloto, 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.
• 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 copiloto.
• Identidade visual: forneça ícones e informações de identidade visual para sua ação para fins de distribuição.

Observação

O Copilot para Microsoft 365 também pode ser estendido com agentes de copiloto.

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

Depois que uma ação é publicada, o administrador do copiloto deve revisar e habilitar o plug-in para uso. Quando um administrador habilita um copiloto, 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 copiloto. 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 plug-in também pode ser exportado para uso em outros copilotos. 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ção, onde todos os usuários do Copilot Studio podem usar para estender seus copilotos 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 copiloto personalizado com uma ação

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

Estender um Microsoft Copilot com uma ação

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

Ele pode ser usado para estender copilotos personalizados ou copilotos fornecidos pela Microsoft. Depois de escolher o copiloto que você gostaria de estender, ele orientará 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 copilotos.

• 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:

• Conversa: uma ação de conversa interna do Microsoft Copilot Studio permite que você estenda o comportamento do seu copiloto. Você pode criar novas habilidades que não estão nativamente no Microsoft 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 do Microsoft 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: os fluxos da nuvem do Microsoft Power Automate podem ser chamados de um copiloto 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 um chat do Microsoft Copilot 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 todos os tipos de ação estão disponíveis para todos os copilotos:

Recurso	Copilot para Microsoft 365	Copilot para vendas	Copilot no Dynamics 365 Customer Service
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 Copiloto.

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 copiloto.

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 copiloto 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 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. Os cartões adaptáveis fornecem uma maneira alternativa de exibir os resultados de uma consulta do copiloto.

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 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 copiloto. Qualquer campo deixado em branco no modelo padrão não aparece no cartão adaptável do copiloto.

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.

Usar ações no Microsoft Copilot

Os usuários finais em seu locatário podem usar ações de conversa e IA em seus chats com o Microsoft 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 "Copilot para Microsoft 365" no centro de administração do Power Platform
• O usuário final habilita a conexão de dentro de seu chat com o Microsoft 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 habilitar o aplicativo em chats com o Microsoft 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 Copilot para Microsoft 365 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 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 podem gerenciar a configuração de integração com Copilot para Microsoft 365 em escala usando grupos de ambiente.

Habilitar a conexão no Microsoft Copilot

Os usuários finais do Microsoft Copilot precisam ativar plug-ins 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 plug-ins no chat com o Microsoft 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 no Microsoft 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	Descrição
Criar ações de conversa para o Microsoft Copilot	Estenda um Microsoft Copilot criando ações que possam responder à pergunta de um usuário com dados extras.
Estender o Microsoft Copilot com ações de prompt (versão preliminar)	Estender um Microsoft Copilot com uma ação de prompt.
Estender o Microsoft Copilot com ações de fluxo (versão preliminar)	Estender um Microsoft Copilot criando uma ação de fluxo.
Estender o Microsoft Copilot com ações do conector (versão preliminar)	Estender um Microsoft Copilot criando uma ação de conector.
Estender o Copilot para Microsoft 365 com agentes	Estender o Copilot para Microsoft 365 com um agente de copiloto.
Usar ações com copilotos 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.