Visão geral de conectores, ações e extensões do Copilot (visão geral)

[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 no qual 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 extensões existentes para um copiloto

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

As etapas para exibir extensões existentes para um copiloto dependem do tipo de copiloto:

• Copiloto personalizado: selecione Ações.
• Microsoft Copilot: selecione Extensões ou Ações, dependendo do que é mostrado para o copiloto.

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

Criando sua própria nova extensão

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

As etapas dependem do tipo de copiloto:

• Copiloto personalizado: selecione Adicionar uma ação.
• Microsoft Copilot: dependendo do que for mostrado para o copiloto, selecione Adicionar extensão e, em seguida , Nova ação ou 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.
• Forneça comportamentos: 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.

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, eliminando a necessidade de recriar a ação para cada ambiente no qual você deseja usá-lo.

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
• Envie 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 que você deseja incluir no plug-in
• Defina parâmetros de entrada e de saída para cada ação
• 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ê pode 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 extensão

As extensões criadas no Copilot Studio têm alguns componentes que são reunidos para criar a ação para uso em copilotos.

• Manipuladores e fontes de conteúdo
• Autenticação
• Ações
• 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. Elas são configuradas de forma semelhante a um tópico padrão no Copilot Studio criado na tela do 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 ações específicas que podem ser usadas 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:

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:

• Não autenticado: 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 seu fonte de dados, ele terá seu método de autenticação integrado ao conector. Você não o configurará na configuração, mas precisará 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 após a criação.
• 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 já definidas, mas ao configurar, você pode selecionar qual das ações deseja usar. Você pode selecionar qualquer número de ações para usar com a origem. Por exemplo, com várias ações, você pode executar o seguinte:

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

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

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

O consentimento do usuário é uma alternância fornecida em cada ação. Ele determina se o copiloto solicitará que os usuários continuem ao executar uma ação. Ativar essa opção significa que o copiloto perguntará aos usuários se eles têm certeza de que desejam executar a ação. Isso 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. É assim que as referências usadas na consulta são exibidas para obter mais informações. Ela permite a inclusão de um título, URL e subtítulo. Essas também são listas suspensas que podem ser preenchidas com base na seleção do caminho raiz.

Testes

Para ações do conector, um criador pode testar o novo plug-in dentro do Microsoft 365 fazendo sideload do plug-in criado. Esta é uma opção na tela de revisão quando a ação é criada. Ele solicitará que o usuário selecione ou crie uma conexão e, em seguida, crie uma versão de teste com sideload do plug-in disponível no ambiente M365. Isso não é visível externamente e não é publicado para aprovação do administrador. Ele só está disponível para o autor para que possa ser usado apenas para validar se o plug-in está funcionando, 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.
• Sua plataforma Power administrador de ambiente habilitou a configuração "Copilot for Microsoft 365" no centro de administração da plataforma Power
• O usuário final habilita a conexão de dentro de seu chat com o Microsoft Copilot.

Implante o Copilot Studio aplicativo no Microsoft 365 centro de administração (admin)

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 M365 Chat usando o aplicativo "Copilot Studio".
• Mostrando Ações de fluxo no aplicativo M365 Chat usando o aplicativo "Power Automate".
• Ações do conector e ações da API no aplicativo M365 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 Power Platform centro de administração (admin)

1. Acesse o Power Platform centro de administração usando sua conta de administrador.
2. Vá para Ambientes e Select o ambiente da lista.
3. Selecione Configurações.
4. Em Produto, Select Recursos
5. Encontre a configuração do M365 Copilot e ative-a (ou desative-a ) para permitir a integração de extensões do Copilot deste ambiente.
6. Role para baixo e selecione Salvar.

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 Copiloto do Power Platform
• Como posso obter dados de um sistema externo?
• Como posso obter dados do Salesforce?

Compartilhar ações de IA

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