Conecte o Salesforce Agentforce ao Microsoft Agent 365

Use este guia para conectar o Salesforce Agentforce ao Microsoft Agent 365 e para coletar atividades de sessão do Agentforce para observabilidade de agentes de terceiros.

Antes de começar

  • Confirme se o administrador de IA do Agent 365 pode criar conexões no Centro de administração do Microsoft 365.
  • Peça a um administrador do Salesforce para completar as etapas do Salesforce neste artigo.
  • Confirme que o Einstein Generative AI e o Agentforce estão ativados na organização Salesforce.
  • Para coletar atividade, confirme que o Data 360 (antigo Data Cloud) está disponível na organização.

Crie um aplicativo externo do Salesforce

  1. No Salesforce, selecione Configurar e depois procure por Gerenciador de Aplicativos.
  2. Abra o Gerenciador de Aplicativos Cliente Externo e então selecione Novo Aplicativo Cliente Externo.
  3. Insira o nome do aplicativo e o e-mail de contato.
  4. Selecione Habilitar OAuth e insira uma URL de Callback, como https://login.salesforce.com/services/oauth2/success.
  5. Em Escopos OAuth, adicione estes escopos:
    • Acessar serviços de chatbot (chatbot_api)
    • Acessar a Plataforma de API do Salesforce (sfap_api)
    • Gerenciar dados do usuário por meio de APIs (api)
    • Executar solicitações a qualquer momento (refresh_token, offline_access)
  6. Em Habilitação de Fluxo, selecione Habilitar Fluxo de Credenciais do Cliente e, em seguida, selecione Criar.
  7. Na aba Políticas do app, selecione Editar. Em Políticas OAuth, ative Habilitar o Fluxo de Credenciais do Cliente.
  8. Defina Run As para um usuário ativo que tenha acesso à API e então selecione Salvar. Para coletar atividade, esse usuário também deve ser capaz de consultar o espaço de dados do Data 360.
  9. Na aba Configurações do app, expanda Configurações OAuth, selecione Chave e segredo do consumidor e registre a chave do consumidor e o segredo do consumidor. Depois, copie a URL atual do Meu Domínio do Configurar>Meu Domínio.

Ative o rastreamento de sessões do Agentforce

O Agent 365 coleta atividade do Agentforce a partir dos dados de Rastreamento de Sessão do Agentforce no Data 360. Ative o rastreamento antes que os agentes sejam executados. Sessões que rodam enquanto o rastreamento está desligado não são gravadas e não podem ser coletadas depois.

  1. Se o Data 360 não estiver configurado, vá para Configuração>Configuração do Data 360 (Configuração do Data Cloud em algumas organizações) e selecione Introdução. O provisionamento pode levar até uma hora.
  2. No Setup, procure por Pacotes Instalados e confirme que o Modelo de Dados Padrão Salesforce é a versão 1.130 ou posterior. Para configurá-lo, veja Configurar Rastreamento de Sessão do Agentforce.
  3. Em Setup, procure por Einstein Generative AI e então selecione Einstein Audit, Analytics, and Monitoring Setup.
  4. Ative o Rastreamento de Sessão do Agentforce se ainda não estiver ativado. Se for solicitado um espaço de dados, selecione padrão.
  5. Ative Agent Platform Tracing e auditoria e feedback.

Criar a conexão

  1. Abra o Centro de administração do Microsoft 365.
  2. Selecionar Agentes>Todos os Agentes.
  3. Nas plataformas conectadas, selecione Gerenciar.
  4. Selecione + Conecte uma plataforma e escolha Salesforce Agentforce.
  5. Insira a URL do My Domain sem caminho, a chave do consumidor e o segredo do consumidor.
  6. Valide as credenciais.
  7. Salve a conexão.
  8. Selecione Sincronizar agentes.

Novas conexões coletam dados de observabilidade por padrão. Se você criou a conexão antes da observabilidade estar disponível, edite-a e selecione Coletar dados de observabilidade do agente.

Verifique a conexão e a atividade

  1. Abra a conexão e confirme que a sincronização foi bem-sucedida e que os agentes esperados aparecem.
  2. Execute uma conversa com um agente ativo. Por exemplo, no Agentforce Builder, use o painel Preview no modo Live Test e anote o ID da sessão.
  3. (Opcional) No aplicativo Data 360, abra o Data Explorer e selecione o espaço de dados habilitado, Objetos de Modelo de Dados e Sessão do Agente de IA. Confirme que existe uma linha para o ID da sessão.
  4. No centro de administração do Microsoft 365, abra a conexão e selecione Sync agents. O Agent 365 coleta novas sessões a cada sincronização da conexão.
  5. Em Agentes>, abra o agente, selecione Atividade e confirme que Sessões é pelo menos 1.

As primeiras sessões após ativar o rastreamento podem levar até duas horas para chegar ao Data 360. Se Sessions continuar 0, espere alguns minutos e sincronize novamente. Usuários ativos mostra N/A porque as sessões do Agentforce não incluem identidades do Microsoft Entra.

Note

Em alguns casos, o Data 360 não atualiza os fluxos de dados conforme programado. No app Data 360, abra os Fluxos de Dados, abra cada fluxo de rastreamento de sessão do Agentforce e selecione Atualizar Agora.

Troubleshoot

Sintoma Causa provável Resolução
A validação de credenciais falha O fluxo de credenciais do cliente não está ativado nem nas configurações do app nem nas Políticas OAuth, o Executar As não está definido, ou a URL não é a URL do Meu Domínio Corrija o app e a URL. Um novo aplicativo pode levar alguns minutos para processar o fluxo.
Um agente não aparece após a sincronização O agente não está ativo, ou o usuário Run As não pode acessá-lo Ative o agente no Agentforce Builder, verifique as permissões do usuário Executar como e sincronize novamente.
O Agentforce Session Tracing não está disponível O Data 360 não está provisionado, o Agentforce está desligado, ou o Modelo de Dados Standard do Salesforce é anterior ao 1.130 Complete a ativação do rastreamento de sessão do Agentforce.
Uma sessão não aparece no Data 360 O rastreamento estava desligado durante a conversa, ou o fluxo de dados não se atualizou Inicie uma nova conversa depois que o rastreamento estiver ativado. Nas organizações da Developer Edition, selecione Atualizar Agora nos fluxos de dados.
Uma sessão aparece no Data 360, mas a Atividade está vazia A coleta está desativada, a conexão não sincronizou desde a conversão, o rastreamento usa outro espaço de dados, ou o usuário Run As não pode consultar o Data 360 Selecione Coletar dados de observabilidade do agente, sincronize novamente e conceda ao usuário Run As acesso a esses dados, por exemplo, com o conjunto de permissões Data Cloud Architect (anteriormente Data Cloud Admin).

Revogar o acesso

Revogue o acesso desativando ou excluindo o aplicativo cliente externo do Salesforce, rotacionando o segredo do consumidor ou removendo o acesso à API do usuário Run As.

Para problemas de conexão que não são específicos do Salesforce Agentforce, veja Solucionar problemas em plataformas conectadas.

  • Last updated on