Agente de Inteligência de Conta do Jitterbit

Visão geral

O Jitterbit oferece o Agente de Inteligência de Conta aos clientes através do Jitterbit Marketplace. Este agente ajuda representantes de contas a gerenciar seus pipelines de forma mais eficaz, fornecendo uma lista diária e priorizada de tarefas da conta e processando automaticamente notas de reunião em registros do Salesforce. O agente monitora o Salesforce em busca de tarefas abertas e relatórios de oportunidades, processa notas de reunião recuperadas do Gmail e entrega resultados através de mensagens do Slack e digests de email agendados.

O agente recebe solicitações sob demanda através do Slack e usa um LLM para identificar a intenção do usuário e recuperar as informações relevantes do Salesforce. Para notas de reunião, o agente consulta uma caixa de entrada dedicada do Gmail em busca de emails contendo links do Google Docs, extrai itens de ação e participantes usando um LLM e cria registros correspondentes de Tarefa e Evento no Salesforce. O estado da sessão e os tokens OAuth são mantidos no Jitterbit Cloud Datastore.

O agente executa as seguintes tarefas:

• Recebe solicitações em linguagem natural de usuários através do Slack e retorna uma lista priorizada de tarefas abertas ou relatórios de oportunidades.
• Recupera tarefas abertas do Salesforce atribuídas ao usuário solicitante, escopo dos últimos 7 dias e próximos 30 dias.
• Recupera relatórios de exceção de uma pasta configurada do Salesforce e os retorna ao usuário solicitante.
• Consulta uma caixa de entrada dedicada do Gmail em busca de emails de notas de reunião do remetente configurado, recupera o Google Doc vinculado e extrai itens de ação e participantes usando um LLM.
• Cria registros de Tarefa e Evento do Salesforce para cada participante identificado em uma nota de reunião.
• Envia mensagens diretas do Slack aos participantes da reunião com um resumo da reunião e seus itens de ação atribuídos.
• Envia digests de email agendados e notificações do Slack aos usuários registrados contendo suas tarefas abertas e resumos de relatórios.

Este documento explica como configurar e operar este agente de IA. Ele aborda a arquitetura e os pré-requisitos, orientações sobre como solicitar ao agente e etapas para instalar, configurar e operar o agente de IA.

Arquitetura do agente de IA

Este agente de IA expõe inteligência de conta através de uma interface conversacional do Slack e fluxos de trabalho automatizados e agendados. O agente opera em dois fluxos principais.

Solicitações do Slack sob demanda

Uma interação típica sob demanda segue estas etapas:

1. Um usuário envia uma mensagem em linguagem natural para o Agente de Inteligência de Conta através do Slack.
2. O agente chama o LLM para identificar a intenção do usuário e selecionar a ferramenta apropriada a invocar.
3. A ferramenta selecionada consulta o Salesforce para tarefas abertas do usuário solicitante ou recupera relatórios de uma pasta configurada do Salesforce.
4. O LLM formata os resultados e o agente publica a resposta de volta ao usuário no Slack.

Processamento de notas de reunião

O processamento de notas de reunião segue estas etapas:

1. O agente consulta uma caixa de entrada dedicada do Gmail em busca de emails do remetente configurado de notas de reunião.
2. Para cada novo email, o agente extrai o link do Google Doc e verifica o Cloud Datastore para confirmar que o documento ainda não foi processado.
3. O agente recupera o conteúdo do Google Doc e o envia ao LLM, que extrai participantes da reunião e itens de ação.
4. O agente procura a ID do Contato do Salesforce de cada participante e, em seguida, cria um registro de Tarefa para cada item de ação e um registro de Evento para cada participante.
5. O agente envia a cada participante uma mensagem direta do Slack com o resumo da reunião e seus itens de ação atribuídos.

Diagrama de fluxo de trabalho

O diagrama a seguir mostra os componentes principais e os fluxos de dados para o Agente de Inteligência de Conta.

Pré-requisitos

Você precisa dos seguintes componentes para usar este agente de IA.

Componentes do Harmony

Você deve ter uma licença Jitterbit Harmony com acesso aos seguintes componentes:

• Jitterbit Studio.
• Jitterbit API Manager para expor os endpoints OAuth do Slack e Gmail.
• Jitterbit Cloud Datastore para armazenar tokens OAuth do Gmail, registros de reuniões processados e detalhes de notificação do usuário.
• Jitterbit Account Intelligence Agent adquirido como complemento de licença.

Endpoints suportados

O agente de IA se conecta aos seguintes endpoints. Você pode acomodar outros sistemas modificando as configurações de endpoint e fluxos de trabalho do projeto.

Modelo de linguagem grande (LLM)

O agente de IA usa Azure OpenAI como provedor de LLM. Para usar Azure OpenAI, você deve ter uma assinatura Microsoft Azure com permissões para criar um recurso Azure OpenAI com um modelo implantado.

Sistema CRM

O agente lê e grava registros em Salesforce. Para usar Salesforce, você deve ter uma conta Salesforce com acesso à API e permissões para ler Tarefas, Eventos, Contatos e Relatórios, e para criar registros de Tarefas e Eventos.

Plataforma de email e documentos

O agente se conecta a Gmail para pesquisar uma caixa de entrada dedicada para emails de notas de reunião e a Google Docs para recuperar o conteúdo das notas de reunião. O acesso do Gmail usa credenciais OAuth 2.0, e o acesso do Google Docs usa uma Conta de Serviço da Google Cloud. Para usar esses serviços, você deve ter um projeto Google Cloud com as APIs Gmail, Google Docs e Google Drive habilitadas, além de um ID de Cliente OAuth 2.0 para Gmail e uma Conta de Serviço para Google Docs. Recomenda-se uma caixa de entrada dedicada do Gmail para notas de reunião.

Plataforma de mensagens

O agente usa Slack como sua interface conversacional e canal de notificação. Para usar Slack, você deve ter um workspace Slack com um app Slack configurado para receber e responder mensagens. Para instruções detalhadas sobre como criar um app Slack, consulte Criar um app Slack.

Cloud Datastore

O agente usa Jitterbit Cloud Datastore para armazenar tokens OAuth do Gmail, rastrear documentos de reunião processados para evitar processamento duplicado e manter detalhes do usuário para notificações de email agendadas. O Cloud Datastore faz parte da plataforma Jitterbit Harmony e não requer uma conta de serviço separada, mas o número de armazenamentos de chaves disponíveis depende do nível de Cloud Datastore adquirido pela sua organização.

Prompts do agente

O Agente de Inteligência de Conta recebe solicitações sob demanda como mensagens em linguagem natural enviadas para o app Slack. Esta seção descreve as regras para prompts eficazes e fornece prompts de exemplo.

Diretrizes de prompt

Siga estas diretrizes ao enviar mensagens para o agente:

• As solicitações são limitadas ao usuário que envia a mensagem. O agente recupera tarefas e relatórios associados à sua conta de usuário Salesforce, com base no seu endereço de email Slack.
• Consultas de tarefas abertas retornam tarefas dos últimos 7 dias e dos próximos 30 dias. Os resultados podem ser imprecisos para filtros de data anteriores a 7 dias.
• Para consultas de tarefas filtradas por data, inclua a data de destino em sua mensagem usando um formato de data reconhecível (por exemplo, "antes de 30 de abril" ou "antes de 2026-04-30").
• Para consultas de relatório, forneça o nome exato do contato Salesforce conforme aparece em seu perfil de usuário Salesforce.

Prompts de exemplo

Os prompts de exemplo a seguir mostram os tipos de solicitações que o agente pode lidar. Substitua [Date] pela sua data de destino.

Tarefas abertas

Use esses prompts para recuperar suas tarefas abertas do Salesforce:

Relatórios

Use este prompt para recuperar detalhes do relatório de exceção de um contato específico. Substitua [Contact Name] pelo nome exato do contato conforme aparece em seu perfil de usuário do Salesforce:

Instalação, configuração e operação

Siga estas etapas para instalar, configurar e operar este agente de IA:

1. Baixar e instalar o projeto
2. Configurar o Google Cloud
3. Criar recursos do Microsoft Azure
4. Criar o aplicativo Slack
5. Configurar o Cloud Datastore
6. Configurar variáveis do projeto
7. Testar conexões
8. Implantar o projeto
9. Criar APIs customizadas do Jitterbit
10. Concluir a autorização OAuth do Gmail
11. Revisar fluxos de trabalho do projeto
12. Acionar os fluxos de trabalho do projeto

Para orientação sobre solução de problemas, consulte Solução de problemas.

Baixar e instalar o projeto

Siga estas etapas para instalar o projeto do Studio para o agente de IA:

1. Faça login no portal do Harmony em https://login.jitterbit.com e abra o Marketplace.

2. Localize o agente de IA chamado Jitterbit Account Intelligence Agent. Para localizá-lo, use a barra de pesquisa ou, no painel Filtros em Tipo, selecione AI Agent para limitar a exibição apenas aos agentes de IA.

3. Clique no link Documentação do agente para abrir sua documentação em uma aba separada. Mantenha a aba aberta para consultar depois de iniciar o projeto.

4. Clique em Iniciar Projeto para abrir um diálogo de configuração em duas etapas.

   Nota

   Se ainda não tiver adquirido o agente de IA, será exibido Obter este agente. Clique nele para abrir um diálogo informativo e, em seguida, clique em Enviar para que um representante entre em contato com você sobre a compra do agente de IA.

5. Na etapa 1 de configuração, Baixar Personalizações, baixe o arquivo de manifesto do aplicativo Slack fornecido. Você usará este arquivo ao criar o aplicativo Slack.

6. Clique em Próximo.

7. Na etapa 2 de configuração, Criar um Novo Projeto, selecione um ambiente onde o projeto do Studio será criado e clique em Criar Projeto.

8. Após o diálogo de progresso indicar que o projeto foi criado, use o link do diálogo Ir para o Studio ou abra o projeto diretamente na página Projetos do Studio.

Configurar o Google Cloud

O agente requer dois tipos de credenciais do Google: credenciais OAuth 2.0 para acesso ao Gmail e uma Conta de Serviço para acesso ao Google Docs.

Configurar OAuth do Gmail

A autenticação do Gmail usa OAuth 2.0. Cada ambiente de implantação requer suas próprias credenciais OAuth porque o URI de redirecionamento é específico do ambiente.

Siga estas etapas para cada ambiente onde implantar o agente:

1. Implante primeiro o projeto do Studio e anote a URL base do API Gateway em API Manager > Minhas APIs. Esta URL é necessária ao registrar o URI de redirecionamento do OAuth no Google Cloud.

2. No Google Cloud Console, abra seu projeto ou crie um novo para esta integração.

3. Ative as seguintes APIs em APIs & Services > Biblioteca:

   • Gmail API
   • Google Drive API

4. Configure a tela de consentimento do OAuth em APIs & Services > Tela de consentimento do OAuth. Selecione Interno se a conta dedicada do Gmail pertence a uma organização do Google Workspace. Selecione Externo para uma conta Gmail pessoal. Adicione os seguintes escopos do OAuth:

   • https://www.googleapis.com/auth/gmail.readonly
   • https://www.googleapis.com/auth/drive.readonly

5. Crie uma ID de Cliente OAuth 2.0 em APIs & Services > Credenciais. Selecione Aplicação web como o tipo de aplicação.

6. No campo URIs de redirecionamento autorizados, adicione a URL do endpoint /oauth/callback usando a URL base do API Gateway anotada na etapa 1, no formato: https://<your-org>.jitterbit.com/oauth/callback.

7. Copie o ID do cliente e o Segredo do cliente gerados. Armazene-os com segurança e insira-os como variáveis de projeto ao configurar variáveis de projeto.

Configurar uma Conta de Serviço do Google Docs

O acesso ao Google Docs usa uma Conta de Serviço em vez de credenciais OAuth de usuário.

Siga estas etapas:

1. No Google Cloud Console, abra o mesmo projeto usado para OAuth do Gmail ou crie um novo.

2. Ative a API do Google Docs em APIs & Services > Library.

3. Em IAM & Admin > Service Accounts, clique em Create Service Account. Digite um nome e uma descrição e clique em Create and Continue.

4. Atribua uma função apropriada à conta de serviço (por exemplo, Viewer) e clique em Done.

5. Clique na conta de serviço para abrir seus detalhes e selecione a aba Keys.

6. Clique em Add Key > Create new key, selecione JSON e clique em Create. Salve o arquivo de chave JSON baixado com segurança.

7. No arquivo de chave JSON, copie os valores client_email e private_key. Insira-os como variáveis de projeto ao configurar variáveis de projeto.

Criar recursos do Microsoft Azure

Crie os seguintes recursos do Microsoft Azure e anote as informações para configurar o agente de IA. Para criar e gerenciar esses recursos, você deve ter uma assinatura do Microsoft Azure com as permissões apropriadas.

Você deve criar um recurso do Azure OpenAI e implantar um modelo por meio do portal do Azure AI Foundry.

Anote o nome da implantação, a URL do endpoint e a chave de API. Insira esses valores ao configurar variáveis de projeto.

Para encontrar esses valores, siga estas etapas:

1. No portal do Azure AI Foundry, abra o recurso do OpenAI específico.

2. Na página de destino do recurso, copie a URL do endpoint e a chave de API.

3. No menu de navegação em Shared resources, selecione Deployments. Copie o nome da implantação.

Criar o aplicativo Slack

Para ativar a interface do Slack do agente, siga estas etapas:

1. Crie um aplicativo Slack usando o arquivo de manifesto baixado em Download and install the project. O manifesto pré-configura o usuário bot (exibido como Account Wingman Assistant), escopos OAuth e inscrições de eventos para o Account Intelligence Agent. Instale o aplicativo em seu workspace do Slack.

2. Obtenha o token do bot e guarde-o para a variável de projeto Bot_oauth_user_token.

3. Adicione um comando de barra do Slack ao aplicativo, apontando a Request URL para o endpoint de API personalizado /connect-gmail. Esse comando permite que um administrador acionem o fluxo de autorização OAuth do Gmail diretamente do Slack.

Configurar o Cloud Datastore

O agente usa três armazenamentos de chave do Cloud Datastore para gerenciar credenciais OAuth, eliminar duplicatas de reuniões processadas e armazenar detalhes de notificação do usuário:

Crie os seguintes armazenamentos de chave no Jitterbit Cloud Datastore. Os campos Key, AlternativeKey e Value estão presentes por padrão.

AIA_Authorized_Users

Crie um armazenamento de chave chamado AIA_Authorized_Users. Nenhum campo personalizado é necessário.

AIA_Processed_Meetings

Crie um armazenamento de chave chamado AIA_Processed_Meetings. Nenhum campo personalizado é necessário.

AIA_Notification_User_details

Crie um armazenamento de chave chamado AIA_Notification_User_details. Adicione os seguintes campos personalizados:

Configurar variáveis de projeto

No projeto do Studio instalado do Marketplace, defina valores para as seguintes variáveis de projeto.

Para configurar variáveis de projeto, use o menu de ações do projeto e selecione Project Variables (Variáveis de projeto) para abrir a gaveta de configuração.

Ative Mask Value (Mascarar valor) para todos os campos de credencial e token.

Salesforce

Azure OpenAI

Cloud Datastore

Slack

Gmail e Google

Testar conexões

Teste as configurações de endpoint para verificar a conectividade usando os valores de variáveis de projeto definidos.

Para testar as conexões, acesse a aba Project endpoints and connectors da paleta de componentes de design, passe o mouse sobre cada endpoint e clique em Test.

Implantar o projeto

Implante o projeto Studio.

Para implantar o projeto, use o menu de ações do projeto e selecione Deploy.

Criar APIs personalizadas do Jitterbit

O agent requer três APIs personalizadas. Crie cada uma usando a opção Publish as an API.

Manipulador de eventos do Slack

Crie uma API personalizada para a operação Slack Bot Request no fluxo de trabalho Main Entry - Slack API Request Handler.

Configure estas configurações para o serviço:

Após publicar, copie a URL do serviço de API e cole-a no campo Event Subscriptions > Request URL do seu app do Slack.

Endpoints OAuth do Gmail

Crie duas APIs customizadas adicionais para o fluxo OAuth do Gmail:

endpoint connect-gmail — dispara a tela de consentimento OAuth do Google para um administrador:

endpoint oauth/callback — recebe o código de autorização após o Google redirecionar:

Após publicar ambos os endpoints, volte ao Google Cloud Console e confirme que a Authorized redirect URI do seu OAuth 2.0 Client ID corresponde exatamente à URL /oauth/callback.

Concluir a autorização OAuth do Gmail

Após implantar as APIs, execute o fluxo de autorização OAuth para gerar e armazenar o token de atualização do Gmail:

1. Dispare o endpoint da API /connect-gmail. Você pode fazer isso a partir de um navegador, usando o comando de barra do Slack configurado em Criar o app do Slack, ou chamando o endpoint diretamente.

2. Faça login com a conta do Gmail dedicada para anotações de reuniões e conceda as permissões solicitadas para Gmail e Google Drive na tela de consentimento do Google.

3. O Google redireciona para o endpoint /oauth/callback. O agente troca o código de autorização por tokens de acesso e atualização e armazena o token de atualização no armazenamento de chave Cloud Datastore AIA_Authorized_Users automaticamente.

4. No projeto do Studio, abra Project Variables e confirme que refresh_token agora tem um valor não vazio. Se ainda estiver em branco, verifique os logs de operação OAuth Callback e Exchange Token para erros.

Revisar workflows do projeto

O projeto do Studio contém 6 workflows que implementam a funcionalidade do Account Intelligence Agent, organizados em três grupos funcionais.

Tratamento de solicitações

Main Entry - Slack API Request Handler

Este workflow é disparado pela API customizada do Jitterbit cada vez que um usuário envia uma mensagem para o bot do Slack. Gerencia solicitações recebidas do bot do Slack e mantém o armazenamento de chave Cloud Datastore AIA_Notification_User_details para manter os detalhes do usuário do Slack disponíveis para workflows de notificação por e-mail agendados. Após rotear a solicitação, este workflow passa as informações necessárias para o workflow Main - AI Agent Tools Logic.

Main - AI Agent Tools Logic

Este workflow recebe a solicitação recebida do workflow Main Entry - Slack API Request Handler, a analisa usando o LLM para identificar a função pretendida e prepara um payload para invocar o workflow da ferramenta de agente apropriada. Este workflow também gerencia todas as solicitações de LLM e captura respostas de LLM para uso posterior.

Monitoramento de conta

Agent - Open Task Monitoring

Este fluxo de trabalho recupera tarefas abertas do Salesforce para o usuário que enviou a solicitação do Slack. A operação master (SF_Open_Task_Monitoring) verifica um ID de usuário do Slack, chama a operação Get Slack User Profile para obter o endereço de email do usuário, consulta o Salesforce para localizar o registro do usuário correspondente e então recupera todas as tarefas com status "Not Started" que caem nos últimos 7 dias e nos próximos 30 dias.

Agent - Exception Report Monitor

Este fluxo de trabalho recupera relatórios de exceção de uma pasta configurada do Salesforce. Para autenticar diretamente na API do Salesforce, primeiro obtém um token de acesso do Salesforce via OAuth. Em seguida, mapeia o email do Slack do usuário solicitante para seu registro de usuário do Salesforce, recupera a lista de relatórios da pasta especificada pela variável de projeto SF_Folder_Id e busca os detalhes de cada relatório relevante para construir a resposta final.

Notas de reunião e notificações

Agent - Meeting Notes

Este fluxo de trabalho manipula o pipeline completo de notas de reunião. Um administrador ativa o fluxo OAuth do Gmail por meio do endpoint da API /connect-gmail. O fluxo de trabalho troca o código de autorização por tokens OAuth e armazena o token de atualização no armazenamento de chave Cloud Datastore AIA_Authorized_Users. Em cada execução programada, o fluxo de trabalho autentica-se no Gmail, consulta a caixa de entrada em busca de emails de notas de reunião do remetente configurado e extrai o link do Google Doc de cada email. Verifica o armazenamento de chave AIA_Processed_Meetings para pular qualquer documento já processado. Para novos documentos, recupera o conteúdo do Google Docs, envia-o ao LLM para extrair participantes e itens de ação, pesquisa o ID de Contato do Salesforce de cada participante e cria registros de Tarefa e Evento no Salesforce. Cada participante também recebe uma mensagem direta do Slack com o resumo da reunião e seus itens de ação atribuídos.

Tool - Schedules Notification Email

Este fluxo de trabalho é executado em um cronograma para entregar resumos diários de tarefas e relatórios a todos os usuários registrados no armazenamento de chave Cloud Datastore AIA_Notification_User_details. Para cada usuário, chama a operação Get Slack User Profile para confirmar que o usuário tem um endereço de email associado, invoca a operação Main-AI Logic para compilar tarefas abertas e relatórios em um layout formatado para email e envia o resumo tanto para o canal do Slack do usuário quanto para seu endereço de email.

Dispare os workflows do projeto

O workflow Main Entry - Slack API Request Handler é disparado automaticamente quando os usuários enviam mensagens para o bot do Slack. Nenhuma operação manual é necessária para iniciar interações sob demanda.

Estes workflows devem ser configurados para executar uma vez por dia usando agendamentos de operação:

• Agent - Exception Report Monitor

• Agent - Meeting Notes

  Nota

  Apenas a operação Query Token neste workflow requer um agendamento. Configure-a para executar uma vez por dia.

• Agent - Open Task Monitoring

• Tool - Schedules Notification Email

  Nota

  A consulta padrão recupera dados limitados ao dia atual, portanto executá-la mais de uma vez por dia retorna resultados duplicados.

Para configurar um agendamento, abra o menu de ações da operação e selecione Settings > Schedules.

Solução de problemas

Se encontrar problemas, consulte os seguintes logs para informações detalhadas de solução de problemas:

• Logs de API
• Logs de operação

Para erros de OAuth do Gmail, verifique os logs de operação OAuth Callback e Exchange Token. Confirme que o URI de redirecionamento no Google Cloud Console corresponde exatamente à URL do API Gateway /oauth/callback implementada, sem barra final.

Para obter assistência adicional, entre em contato com o suporte Jitterbit.