Compartilhar via


Conectar seus agentes a uma fonte de dados

Agentes como o Agente de Vendas precisam se conectar a uma fonte de dados para coletar dados. Isso é feito configurando uma conexão de servidor para servidor com a fonte de dados. Essa conexão permite que o agente seja executado em segundo plano e acesse e recupere dados da fonte de dados sem exigir interação do usuário.

Se você estiver usando o Dynamics 365 Sales como seu CRM, o agente se conectará diretamente a ele, pois ele será implantado no mesmo ambiente. Nenhuma etapa de configuração extra é necessária.

Se você estiver usando outros sistemas de CRM, como o Salesforce, o agente precisará se conectar a ele para coletar dados. Isso é feito configurando uma conexão de servidor para servidor.

Configurar a conexão de servidor para servidor com o Salesforce

Quando você configura uma conexão de servidor para servidor com o Salesforce, um aplicativo conectado e um usuário de integração são criados no Salesforce. O aplicativo conectado é usado para autenticar o agente com o Salesforce, enquanto o usuário de integração é usado para acessar dados no Salesforce. O usuário de integração é criado com um conjunto específico de permissões que permitem acessar os dados necessários ao agente.

Habilitar a conexão de servidor para servidor com o Salesforce

  1. Nas configurações de administrador do aplicativo Vendas, selecione Conectores.
  2. Em Conexões do agente, selecione Salesforce.
  3. Ative a opção Ativar acesso .
  4. Clique em Salvar.

A conexão pode levar alguns minutos para ser estabelecida. Depois que a conexão é estabelecida, os detalhes do aplicativo conectado e do usuário de integração são exibidos em Detalhes da conexão.

Se, no futuro, você quiser desativar a conexão de servidor para servidor com o Salesforce, poderá fazê-lo desativando a opção Ativar acesso . Isso exclui o aplicativo conectado e o usuário de integração do Salesforce. O agente não poderá mais acessar dados no Salesforce e você precisará configurar a conexão novamente se quiser usar o agente com o Salesforce.

Observação

Você pode conectar um ambiente do Salesforce a apenas um locatário do Microsoft Entra usando a conexão servidor a servidor. Conectar o mesmo ambiente do Salesforce a vários locatários do Microsoft Entra não é suportado e pode resultar em erros inesperados.

Como a conexão é estabelecida?

Quando uma conexão é estabelecida, os seguintes componentes são criados no Salesforce usando as APIs do Salesforce. Os componentes podem ser visualizados no Salesforce CRM na página Configuração .

  • Aplicativo conectado: usado para autenticar o agente com o Salesforce. O nome do aplicativo conectado é Copilot for Sales connected app.
  • Usuário de integração: usado para acessar dados no Salesforce. O nome do usuário de integração é Copilot for Sales integration user.
  • Conjunto de permissões: usado para conceder ao usuário de integração acesso aos dados necessários para o agente. O nome do conjunto de permissões é Copilot for Sales permission set.

O princípio de privilégio mínimo é seguido para garantir que o usuário de integração tenha apenas as permissões necessárias para acessar os dados exigidos pelo agente. Se o agente for reconfigurado para acessar mais campos personalizados no CRM, a conexão deverá ser recriada para acessá-los corretamente. Uma mensagem de erro é mostrada nesse caso e uma opção para recriar a conexão é disponibilizada.

Se ocorrer um erro que impeça a conexão de funcionar corretamente, uma mensagem de erro será exibida. Selecione Reconectar para recriar a conexão. Essa ação exclui a conexão existente e cria uma nova.

Permissões do usuário de integração

O usuário de integração é criado com um conjunto específico de permissões que permitem acessar os dados necessários ao agente. As permissões são definidas no conjunto Copilot for Sales permission setde permissões. O conjunto de permissões inclui as seguintes permissões:

Object Permissions
Conta Ler, Exibir Tudo
Oportunidade Ler, Exibir Tudo
Cliente Potencial Ler, Editar, Exibir Tudo
Contato Ler, Exibir Tudo
Product2 Leitura

Os seguintes campos são legíveis pelo usuário de integração:

Object Campo
Contato AccountId
Contato Email
Contato MobilePhone
Contato Telefone
Contato Title
Oportunidade Quantidade
Oportunidade AccountId
Oportunidade ExpectedRevenue
Cliente Potencial Email
Cliente Potencial Title
Cliente Potencial Description
Cliente Potencial LeadSource
Cliente Potencial Rating
Cliente Potencial Telefone
Product2 Description