Compartilhar via

Criar um conector personalizado e uma ação de conector (versão preliminar)

  • Artigo

Importante

  • Esta é uma versão prévia do recurso pronta para produção.
  • As versões prévias prontas para produção estão sujeitas a termos de uso complementares.

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

Este artigo apresenta instruções concisas para ajudar você a começar rapidamente a compilar um conector do Microsoft Power Platform usando as APIs de aplicativo, de maneira que você possa estender o Copilot para Vendas. Para obter mais informações abrangentes sobre conectores, acesse Visão geral de conectores.

Depois que tiver compilado o conector personalizado, você deverá criar uma ação no Microsoft Copilot Studio, habilitá-la para os usuários e certificá-la.

Criar e testar um conector personalizado no Microsoft Power Platform

Baixe o arquivo do OpenAI para começar rapidamente com as ações de conector necessárias para estender o Copilot para vendas. O arquivo do OpenAI contém Swagger para uma API projetada a fim de receber sugestões de conteúdo em um email. Você pode desconsiderar esse swagger, pois a interface do usuário do Copilot para vendas não dá suporte à API.

Você pode criar um conector personalizado a partir do Power Apps ou do Power Automate.

Não se esqueça de usar um ambiente onde aplicativos do Dynamics 365 estejam habilitados, pois ambientes desse tipo são usados no suplemento do Outlook Copilot para vendas. Os ambientes sem aplicativos do Dynamics 365, como o ambiente padrão, não são compatíveis para conectores personalizados. Para criar um novo ambiente onde os aplicativos do Dynamics 365 estejam habilitados, vá até Criar um ambiente com um banco de dados.

Ao configurar a autenticação do conector, não se esqueça de usar o tipo de autenticação OAuth 2.0 e a ID do Microsoft Entra como o provedor de autenticação. (A ID do Microsoft Entra era conhecida como Azure Active Directory ou Azure AD.) Dessa forma, seu serviço de back-end pode receber tokens de ID do Microsoft Entra que podem ser trocados quando serviços Microsoft, como Microsoft Graph, são invocados. O conector e o serviço de back-end são protegidos usando dois registros de aplicativo diferentes conforme descrito no artigo Configurar autenticação da ID do Microsoft Entra.

Para obter etapas a fim de criar um conector personalizado, configurar autenticação e testar o conector, vá até Criar um conector personalizado a partir de uma definição do OpenAPI.

Observação

Para criar automaticamente a conexão para plug-ins de conector usando a ID do Microsoft Entra, você deve definir o valor Habilitar em nome de logon "true" na seção Segurança do conector personalizado. Para obter mais informações, consulte Gerenciar conexões

Criar e publicar uma ação no Copilot Studio

As ações determinam quais operações são realizadas com as fontes de dados e os insights personalizados, como os conectores personalizados compilados por você. Elas permitem que o Copilot para vendas identifique as fontes externas que os insights devem ser extraídos para enriquecer a experiência do Copilot para vendas. Você pode criar ações com base no conector desenvolvido por você usando o Copilot Studio. Para saber mais, acesse Criar e configurar plug-ins do copiloto.

Observação

Se Copilot para Vendas não aparecer no Copilot Studio no momento, peça ao administrador para implantar o aplicativo do Teams avançado do Copilot para Vendas.

Habilitar a ação do conector para usuários

Para que os usuários do Copilot para Vendas possam acessar uma ação do conector publicada no Copilot Studio, um administrador do Copilot para Vendas deve habilitá-la. Se você quiser habilitar uma ação do conector para os usuários do copiloto, peça ao administrador para seguir estas etapas.

Observação

  • As ações habilitadas pelo administrador podem demorar até quatro horas para serem ingeridas em experiências do Copilot para vendas.
  • Ao habilitar uma ação do conector do Copilot para Vendas, os usuários do Copilot para Vendas nos aplicativos do Microsoft 365 e do Teams podem enviar e receber dados de fontes externas usando o Copilot para Vendas mesmo que a mesma ação do conector não tenha sido permitida para uso diretamente com o Microsoft 365. Para habilitar uma ação do conector, é recomendável garantir que essa ela esteja em conformidade com as políticas da organização.
  • Os dados e insights que as ações de conector trazem para as experiências do Copilot para Vendas são fornecidos por terceiros. Eles podem estar sujeitos a termos e condições de terceiros e/ou políticas de privacidade. É recomendável validar essas ações de conector para fins de conformidade com as políticas da organização.

Certifique o conector e a ação (opcional)

Depois que você criar um conector personalizado e uma ação de conector no Copilot Studio, eles se tornarão acessíveis no locatário. Se quiser disponibilizar o conector e a ação para todos os usuários do Copilot para vendas, você deverá certificá-los. Saiba mais sobre como certificar o conector e o plug-in do Power Platform. Para certificar o conector e a ação, você deve preparar os arquivos de conector e plug-in do Power Platform para certificação.

Estender Copilot para Vendas do Microsoft 365 com aplicativos de parceiros
Compilar extensões do Copilot para vendas