Agente de Inteligência de Conta Jitterbit

Visão Geral

A Jitterbit fornece o Agente de Inteligência de Conta aos clientes através do Jitterbit Marketplace. Este agente ajuda os representantes de contas a gerenciar seus pipelines de forma mais eficaz, fornecendo uma lista priorizada de tarefas de conta diárias e processando automaticamente as notas de reuniões em registros acionáveis do Salesforce. O agente monitora o Salesforce em busca de tarefas abertas e relatórios de oportunidades, processa notas de reuniões recuperadas do Gmail e entrega os resultados por meio de mensagens no Slack e resumos de email programados.

O agente recebe solicitações sob demanda através do Slack e utiliza um LLM para identificar a intenção do usuário e recuperar as informações relevantes do Salesforce. Para as notas de reuniões, o agente verifica 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 Tarefas e Eventos no Salesforce. O estado da sessão e os tokens OAuth são mantidos no Jitterbit Cloud Datastore.

O agente realiza as seguintes tarefas:

• Recebe solicitações em linguagem natural dos 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, limitadas aos últimos 7 dias e aos próximos 30 dias.
• Recupera relatórios de exceção de uma pasta configurada do Salesforce e os retorna ao usuário solicitante.
• Verifica 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 Tarefas e Eventos no Salesforce para cada participante identificado em uma nota de reunião.
• Envia mensagens diretas no Slack para os participantes da reunião com um resumo da reunião e seus itens de ação atribuídos.
• Envia resumos de email programados e notificações no Slack para usuários registrados contendo suas tarefas abertas e resumos de relatórios.

Este documento explica como configurar e operar este agente de IA. Ele abrange arquitetura e 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 apresenta inteligência de conta através de uma interface conversacional no Slack e fluxos de trabalho automatizados programados. O agente opera em dois fluxos principais.

Solicitações 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 ser invocada.
3. A ferramenta selecionada consulta o Salesforce para as tarefas abertas do usuário solicitante ou recupera relatórios de uma pasta configurada no 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 verifica 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 para o LLM, que extrai os participantes da reunião e os itens de ação.
4. O agente procura o ID de Contato do Salesforce de cada participante, 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 uma mensagem direta no Slack para cada participante 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 principais componentes e 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 do 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.
• Agente de Inteligência de Conta Jitterbit adquirido como um complemento de licença.

Endpoints suportados

O agente de IA se conecta aos seguintes endpoints. É possível acomodar outros sistemas modificando as configurações de endpoint e os fluxos de trabalho do projeto.

Modelo de linguagem grande (LLM)

O agente de IA utiliza o Azure OpenAI como provedor de LLM. Para usar o Azure OpenAI, é necessário ter uma assinatura do Microsoft Azure com permissões para criar um recurso do Azure OpenAI com um modelo implantado.

Sistema CRM

O agente lê e grava registros no Salesforce. Para usar o Salesforce, é necessário ter uma conta do Salesforce com acesso à API e permissões para ler Tarefas, Eventos, Contatos e Relatórios, além de criar registros de Tarefas e Eventos.

Plataforma de email e documentos

O agente se conecta ao Gmail para verificar uma caixa de entrada dedicada para emails de notas de reunião e ao Google Docs para recuperar o conteúdo das notas de reunião. O acesso ao Gmail utiliza credenciais OAuth 2.0, e o acesso ao Google Docs utiliza uma Conta de Serviço do Google Cloud. Para usar esses serviços, é necessário ter um projeto do Google Cloud com a API do Gmail, a API do Google Docs e a API do Google Drive habilitadas, juntamente com um ID de Cliente OAuth 2.0 para o Gmail e uma Conta de Serviço para o Google Docs. Recomenda-se uma caixa de entrada dedicada do Gmail para notas de reunião.

Plataforma de mensagens

O agente utiliza o Slack como sua interface de conversação e canal de notificações. Para usar o Slack, é necessário ter um espaço de trabalho do Slack com um aplicativo Slack configurado para receber e responder a mensagens. Para instruções detalhadas sobre como criar um aplicativo Slack, consulte Criar um aplicativo Slack.

Cloud Datastore

O agente utiliza o 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 é parte da plataforma Jitterbit Harmony e não requer uma conta de serviço separada.

Prompts do Agente

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

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 do Salesforce, com base no seu endereço de email do Slack.
• Consultas de tarefas abertas retornam tarefas dentro dos últimos 7 dias e dos próximos 30 dias. Os resultados podem ser imprecisos para filtros de data mais antigos que 7 dias.
• Para consultas de tarefas filtradas por data, inclua a data alvo 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órios, forneça o nome exato do contato do Salesforce conforme aparece em seu perfil de usuário do Salesforce.

Exemplos de Prompts

Os seguintes exemplos de prompts mostram os tipos de solicitações que o agente pode lidar. Substitua [Data] pela sua data alvo.

Tarefas Abertas

Use estes prompts para recuperar suas tarefas abertas do Salesforce:

Relatórios

Use este prompt para recuperar detalhes do relatório de exceção para um contato específico. Substitua [Nome do Contato] 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. Baixe e instale o projeto
2. Configure o Google Cloud
3. Crie recursos do Microsoft Azure
4. Crie o aplicativo Slack
5. Configure o Cloud Datastore
6. Configure as variáveis do projeto
7. Teste as conexões
8. Implante o projeto
9. Crie APIs personalizadas do Jitterbit
10. Complete a autorização OAuth do Gmail
11. Revise os fluxos de trabalho do projeto
12. Acione os fluxos de trabalho do projeto

Para orientações de 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 Harmony em https://login.jitterbit.com e abra o Marketplace.

2. Localize o agente de IA chamado Jitterbit Account Intelligence Agent. Para localizar o agente, use a barra de pesquisa ou, no painel Filtros, sob Tipo, selecione Agente de IA para limitar a exibição a agentes de IA.

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

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

   Nota

   Se você ainda não comprou o agente de IA, Obter este agente é exibido em vez disso. Clique nele para abrir uma caixa de diálogo informativa, em seguida, clique em Enviar para que um representante entre em contato com você sobre a compra do agente de IA.

5. Na etapa de configuração 1, 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 de configuração 2, Criar um Novo Projeto, selecione um ambiente onde o projeto do Studio será criado e, em seguida, clique em Criar Projeto.

8. Após a caixa de diálogo de progresso indicar que o projeto foi criado, use o link da caixa de 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 você implanta 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 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 e Serviços > Biblioteca:

   • API do Gmail
   • API do Google Drive

4. Configure a tela de consentimento OAuth em APIs e Serviços > Tela de consentimento OAuth. Se a conta do Gmail dedicada pertence a uma organização do Google Workspace, selecione Interno. Se for uma conta pessoal do Gmail, selecione Externo. Adicione os seguintes escopos OAuth:

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

5. Crie um ID de Cliente OAuth 2.0 em APIs e Serviços > Credenciais. Selecione Aplicativo da Web como o tipo de aplicativo.

6. No campo URIs de redirecionamento autorizados, adicione a URL do endpoint /oauth/callback usando a URL base da API Gateway anotada na etapa 1, no formato: https://<sua-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 do projeto ao configurar variáveis do projeto.

Configurar uma Conta de Serviço do Google Docs

O acesso ao Google Docs utiliza 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 o OAuth do Gmail ou crie um novo.

2. Ative a API do Google Docs em APIs e Serviços > Biblioteca.

3. Em IAM e Admin > Contas de Serviço, clique em Criar Conta de Serviço. Insira um nome e uma descrição, em seguida clique em Criar e Continuar.

4. Atribua um papel apropriado à conta de serviço (por exemplo, Visualizador), em seguida clique em Concluído.

5. Clique na conta de serviço para abrir seus detalhes, em seguida selecione a aba Chaves.

6. Clique em Adicionar Chave > Criar nova chave, selecione JSON e clique em Criar. Salve o arquivo da chave JSON baixado com segurança.

7. Do arquivo da chave JSON, copie os valores client_email e private_key. Insira-os como variáveis do projeto ao configurar variáveis do 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, é necessário ter uma assinatura do Microsoft Azure com as permissões apropriadas.

Você deve criar um recurso do Azure OpenAI e implantar um modelo através do portal do Azure AI Foundry.

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

Para encontrar esses valores, siga estas etapas:

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

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

3. No menu de navegação sob Recursos compartilhados, selecione Implantações. Copie o nome da implantação.

Criar o aplicativo Slack

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

1. Crie um aplicativo Slack usando o arquivo de manifesto baixado em Baixar e instalar o projeto. O manifesto pré-configura o usuário do bot (exibido como Account Wingman Assistant), escopos OAuth e assinaturas de eventos para o Agente de Inteligência de Conta. Instale o aplicativo em seu espaço de trabalho Slack.

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

3. Adicione um comando slash do Slack ao aplicativo, apontando a URL de Solicitação para o endpoint da API personalizada /connect-gmail. Este comando permite que um administrador acione o fluxo de autorização OAuth do Gmail diretamente do Slack.

Configurar Cloud Datastore

O agente utiliza três armazenamentos de chave do Cloud Datastore para gerenciar credenciais OAuth, deduplicar reuniões processadas e armazenar detalhes de notificações de usuários:

Crie os seguintes armazenamentos de chaves em Jitterbit Cloud Datastore:

AIA_Authorized_Users

Crie um armazenamento de chaves chamado AIA_Authorized_Users e adicione os seguintes campos personalizados:

• Key (texto)
• Value (texto)

AIA_Processed_Meetings

Crie um armazenamento de chaves chamado AIA_Processed_Meetings e adicione os seguintes campos personalizados:

• Key (texto)
• Value (texto)

AIA_Notification_User_details

Crie um armazenamento de chaves chamado AIA_Notification_User_details e adicione os seguintes campos personalizados:

• SlackChannel (texto)
• SlackuserID (texto)

Configurar variáveis do projeto

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

Para configurar variáveis do projeto, use o menu de ações do projeto e selecione Variáveis do Projeto para abrir o painel de configuração.

Ative Mascarar Valor para todos os campos de credenciais e tokens.

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 conexões, vá para a aba Endpoints e conectores do projeto no painel de componentes de design, passe o mouse sobre cada endpoint e clique em Testar.

Implantar o projeto

Implante o projeto do Studio.

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

Criar APIs personalizadas do Jitterbit

O agente requer três APIs personalizadas. Crie cada uma usando a opção Publicar como uma API.

Manipulador de eventos do Slack

Crie uma API personalizada para a operação Solicitação do Bot do Slack no fluxo de trabalho Entrada Principal - Manipulador de Solicitação da API do Slack.

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

Após a publicação, copie a URL do serviço da API e cole-a no campo Assinaturas de Evento > URL de Solicitação do seu aplicativo Slack.

Endpoints OAuth do Gmail

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

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

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

Após publicar ambos os endpoints, retorne ao Google Cloud Console e confirme se a URI de redirecionamento autorizada para seu ID de Cliente OAuth 2.0 corresponde exatamente à URL /oauth/callback.

Completar a autorização OAuth do Gmail

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

1. Acione 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 aplicativo Slack, ou chamando o endpoint diretamente.

2. Faça login com a conta do Gmail dedicada às notas da reunião e conceda as permissões solicitadas para o Gmail e o 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 chaves AIA_Authorized_Users do Cloud Datastore automaticamente.

4. No projeto do Studio, abra Variáveis do Projeto e confirme que refresh_token agora possui um valor não vazio. Se ainda estiver em branco, verifique os logs de operação OAuth Callback e Exchange Token em busca de erros.

Revisar fluxos de trabalho do projeto

O projeto do Studio contém 6 fluxos de trabalho que implementam a funcionalidade do Agente de Inteligência de Conta, organizados em três grupos funcionais.

Manipulação de solicitações

Entrada Principal - Manipulador de Solicitações da API Slack

Este fluxo de trabalho é acionado pela API personalizada do Jitterbit sempre que um usuário envia uma mensagem para o bot do Slack. Ele gerencia as solicitações do bot do Slack e mantém o armazenamento de chaves AIA_Notification_User_details do Cloud Datastore para manter os detalhes do usuário do Slack disponíveis para fluxos de trabalho de notificação por email agendados. Após encaminhar a solicitação, este fluxo de trabalho passa as informações necessárias para o fluxo de trabalho Principal - Lógica das Ferramentas do Agente de IA.

Main - AI Agent Tools Logic

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

Monitoramento de conta

Agente - Monitoramento de Tarefas Abertas

Este fluxo de trabalho recupera tarefas abertas do Salesforce para o usuário que enviou a solicitação pelo Slack. A operação mestre (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 o registro de usuário correspondente e, em seguida, recupera todas as tarefas com o status "Não Iniciado" que estão dentro dos últimos 7 dias e dos próximos 30 dias.

Agente - Monitor de Relatório de Exceção

Este fluxo de trabalho recupera relatórios de exceção de uma pasta configurada do Salesforce. Para se autenticar diretamente com a API do Salesforce, primeiro obtém um token de acesso do Salesforce via OAuth. Em seguida, mapeia o email do usuário do Slack que fez a solicitação para o 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

Agente - Notas de Reunião

Este fluxo de trabalho gerencia todo o pipeline de notas de reunião. Um administrador aciona o fluxo OAuth do Gmail através 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 AIA_Authorized_Users do Cloud Datastore. Em cada execução programada, o fluxo de trabalho autentica-se no Gmail, verifica 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. Ele 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 para o LLM para extrair participantes e itens de ação, procura 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 no Slack com o resumo da reunião e seus itens de ação atribuídos.

Ferramenta - Email de Notificação de Agendas

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 AIA_Notification_User_details do Cloud Datastore. Para cada usuário, chama a operação Get Slack User Profile para confirmar que o usuário possui um endereço de email associado, invoca a operação Main-AI Logic para compilar tarefas abertas e relatórios em um formato de email e envia o resumo tanto para o canal do Slack do usuário quanto para seu endereço de email.

Acionar os fluxos de trabalho do projeto

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

Esses fluxos de trabalho devem ser configurados para serem executados uma vez por dia usando cronogramas de operações:

• Agent - Exception Report Monitor

• Agent - Meeting Notes

  Nota

  Somente a operação Query Token neste fluxo de trabalho requer um cronograma. Configure-a para ser executada 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 cronograma, abra o menu de ações da operação e selecione Settings > Schedules.

Solução de Problemas

Se você encontrar problemas, revise os seguintes logs para obter informações detalhadas de solução de problemas:

• API logs
• Operation logs

Para erros de OAuth do Gmail, verifique os logs das operações OAuth Callback e Exchange Token. Confirme se a URI de redirecionamento no Google Cloud Console corresponde exatamente à URL do API Gateway /oauth/callback implantada, sem barra no final.

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