Agente de Anotações de Reunião do Jitterbit

Visão geral

O Jitterbit oferece o Agente de Anotações de Reunião aos clientes através do Jitterbit Marketplace. Este agente automatiza o processamento de anotações de reunião geradas pelo Gemini. O agente consulta uma caixa de entrada dedicada do Gmail, recupera Documentos Google vinculados e se integra com o Salesforce e Slack para manter os participantes da reunião informados e responsáveis.

Em um cronograma diário, o agente recupera novos emails de anotações de reunião do Gmail e extrai o conteúdo do Documento Google vinculado em cada email. O conteúdo extraído é analisado por um LLM, que retorna um resumo estruturado da reunião, próximos passos e itens de ação por participante como resposta JSON. Para cada participante, o agente consulta o Salesforce para recuperar o registro de contato, cria uma Tarefa e um Evento vinculados a esse registro e envia uma mensagem direta personalizada no Slack contendo o resumo da reunião e os itens de ação individuais. Um Cloud Datastore do Jitterbit gerencia o armazenamento de tokens OAuth e deduplicação para evitar reprocessamento. Um fluxo de trabalho secundário expõe a recuperação de tarefas sob demanda através de um gatilho de API.

O agente realiza as seguintes tarefas:

• Consulta uma caixa de entrada do Gmail a cada 24 horas em busca de emails de anotações de reunião do Gemini.
• Recupera e extrai conteúdo de texto de Documentos Google vinculados.
• Deduplicar anotações de reunião processadas usando Cloud Datastore para evitar reprocessamento.
• Gera resumos estruturados de reunião, próximos passos e itens de ação por participante usando um LLM.
• Cria Tarefas e Eventos do Salesforce para cada participante da reunião.
• Envia mensagens diretas personalizadas do Slack com resumos de reunião e itens de ação individuais.
• Responde a consultas de tarefas de reunião sob demanda através de um gatilho de API.

O agente vem pré-configurado para funcionar com esses serviços. Você pode adaptá-lo a outros sistemas modificando as configurações de endpoint e os fluxos de trabalho.

Este documento explica como configurar e operar este agente de IA. Ele cobre arquitetura, pré-requisitos e etapas para instalar, configurar e operar o agente de IA.

Arquitetura do agente de IA

O Agente de Anotações de Reunião é executado como um fluxo de trabalho agendado e autônomo que conecta Gmail, Google Docs, um LLM, Salesforce e Slack através de um projeto Studio. Um armazenamento de chaves do Cloud Datastore armazena tokens OAuth do Gmail e rastreia quais anotações de reunião já foram processadas.

Uma interação típica segue o seguinte processo:

1. Um cronograma de operação dispara o fluxo de trabalho de consulta a cada 24 horas.
2. O agente consulta um armazenamento de chaves do Cloud Datastore para obter o token de atualização OAuth do Gmail armazenado e o troca por um token de acesso atualizado.
3. O agente pesquisa a caixa de entrada do Gmail por emails de gemini-notes@google.com dentro da janela anterior de 24 horas e recupera a lista de IDs de mensagem correspondentes.
4. Para cada email, o agente busca o conteúdo completo da mensagem e extrai a URL do Documento Google incorporado, depois analisa o ID do documento a partir da URL.
5. O agente consulta o armazenamento de chaves do Cloud Datastore para verificar se o ID do documento já foi processado. Se foi, o documento é ignorado.
6. Para novos documentos, o agente escreve o ID do documento como processado no armazenamento de chaves do Cloud Datastore e busca o conteúdo de texto simples da API de exportação do Google Docs.
7. O agente envia o conteúdo do documento para um LLM, que retorna um objeto JSON estruturado contendo o resumo da reunião, próximos passos e itens de ação por participante.
8. Para cada proprietário de item de ação identificado na resposta do LLM, o agente resolve o email do participante a partir da lista de participantes extraída e consulta o Salesforce para recuperar a ID de Contato do participante.
9. O agente cria um registro de Tarefa do Salesforce para cada item de ação e um registro de Evento do Salesforce representando a reunião, ambos vinculados ao contato do participante.
10. O agente envia uma mensagem direta personalizada do Slack para cada participante contendo o resumo da reunião e seus itens de ação individuais.

Diagrama de fluxo de trabalho

O diagrama a seguir mostra o fluxo de trabalho principal de tratamento de requisições do Agente de Notas de Reunião.

Pré-requisitos

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

Componentes Harmony

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

• Jitterbit Studio
• Jitterbit API Manager
• Jitterbit Cloud Datastore
• Agente de Notas de Reunião adquirido como complemento de licença

Endpoints suportados

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

Modelo de linguagem grande (LLM)

O agente usa OpenAI GPT-4o para analisar o conteúdo de notas de reunião e gerar um resumo estruturado da reunião, próximas etapas e itens de ação por participante. Você deve ter uma conta OpenAI com acesso ao modelo GPT-4o e uma chave de API válida.

Gmail

O agente monitora uma caixa de entrada dedicada do Gmail para emails de notas de reunião do Gemini provenientes de gemini-notes@google.com usando a API REST do Gmail. Você deve ter um projeto Google Cloud com a API do Gmail habilitada e credenciais OAuth 2.0 (ID do cliente e segredo do cliente) configuradas para a caixa de entrada.

Google Docs

O agente recupera o conteúdo de documentos do Google Docs usando o método files.export da API Google Drive. O acesso usa as mesmas credenciais OAuth 2.0 do Google configuradas para o Gmail, desde que a conta Google associada tenha acesso de leitura aos documentos de notas de reunião.

Salesforce

O agente consulta registros de contatos do Salesforce e cria registros Task e Event. Você deve ter uma conta Salesforce com nome de usuário de login, senha e token de segurança.

Slack

O agente envia mensagens diretas aos participantes da reunião usando a API Web do Slack. Você deve ter um aplicativo Slack com um token de bot configurado com os seguintes escopos OAuth: users:read, users:read.email, conversations:open e chat:write.

Cloud Datastore

O agente usa Jitterbit Cloud Datastore para armazenar tokens de atualização OAuth do Gmail e rastrear IDs de documentos de reunião processados. 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 Cloud Datastore adquirido pela sua organização.

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. Preparar Cloud Datastore
3. Configurar variáveis do projeto
4. Testar conexões
5. Implantar o projeto
6. Criar a API customizada Jitterbit
7. Configurar credenciais OAuth do Google
8. Autorizar acesso ao Gmail
9. Revisar fluxos de trabalho do projeto
10. Disparar os fluxos de trabalho do projeto

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

Baixar e instalar o projeto

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

1. Faça login no portal Harmony em https://login.jitterbit.com e abra Marketplace.
2. Localize o agente de IA chamado Meeting Notes Agent. Para localizá-lo, use a barra de pesquisa ou, no painel Filters em Type, selecione AI Agent para limitar a exibição a agentes de IA.
3. Clique no link Documentation 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 Start Project para abrir um diálogo de configuração.

1. Na caixa de diálogo Criar um novo projeto, selecione um ambiente onde o projeto Studio será criado e clique em Criar projeto.
2. Após o diálogo de progresso indicar que o projeto foi criado, use o link do diálogo Ir para Studio ou abra o projeto diretamente na página Projetos do Studio.

Preparar Cloud Datastore

O agente usa dois armazenamentos de chaves do Cloud Datastore para armazenar tokens de atualização do OAuth do Gmail e rastrear IDs de documentos de reunião processados:

Crie cada armazenamento de chaves. Os campos Key, AlternativeKey e Value estão presentes por padrão.

AIA_Authorized_Users

Adicione o seguinte campo personalizado:

AIA_Processed_Meetings

Nenhum campo personalizado é necessário.

Após criar cada armazenamento de chaves, configure as atividades associadas do Cloud Datastore no Studio:

1. Na aba Componentes do projeto Studio, em Endpoints, localize cada atividade do Cloud Datastore associada a esse armazenamento.
2. Clique duas vezes para abrir a atividade, atribua o nome do armazenamento e salve.

Configurar variáveis do projeto

No projeto Studio instalado 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 a gaveta de configuração.

Google OAuth

OpenAI

Salesforce

Slack

Cloud Datastore

Testar conexões

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

Para testar conexões, acesse a aba Endpoints do projeto e conectores da paleta de componentes de design, passe o cursor 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 a API personalizada do Jitterbit

Crie uma API personalizada com os seguintes serviços de API:

• Conectar Gmail
• Retorno de Chamada OAuth
• Executar Notas de Reunião
• Conectar Gmail Copilot

Depois de configurar cada serviço de API, publique a API personalizada.

Conectar Gmail

Configure este serviço de API com os seguintes parâmetros:

Retorno de Chamada OAuth

Configure este serviço de API com os seguintes parâmetros:

Executar Notas de Reunião

Configure este serviço de API com os seguintes parâmetros:

Conectar Gmail Copilot

Configure este serviço de API com os seguintes parâmetros:

Configurar credenciais do Google OAuth

Cada ambiente do Jitterbit requer suas próprias credenciais OAuth 2.0 porque o URI de redirecionamento deve corresponder exatamente à URL do serviço de API da API personalizada implantada. Complete as etapas a seguir para criar credenciais para cada ambiente.

Criar um projeto do Google Cloud

1. Abra um navegador e vá para https://console.cloud.google.com. Faça login com uma conta do Google que tenha permissão para criar ou gerenciar projetos do Google Cloud na sua organização.

2. Clique no menu suspenso do seletor de projetos na parte superior da página, ao lado do logotipo do Google Cloud.

3. Na caixa de diálogo que se abre, clique em Novo projeto no canto superior direito.

4. No campo Nome do projeto, insira um nome descritivo como Meeting Notes Agent QA.

5. Selecione sua organização no menu suspenso Organização, se aplicável. Deixe Local como Nenhuma organização se sua conta for pessoal.

6. Clique em Criar. Uma notificação aparece quando o provisionamento é concluído.

7. Clique na notificação ou abra o menu suspenso do seletor de projetos novamente e selecione o novo projeto. Confirme se o nome dele aparece na barra de navegação superior antes de continuar.

Ativar as APIs necessárias

1. Na barra lateral esquerda, vá para APIs e Serviços > Biblioteca.

2. Na barra de pesquisa, digite Gmail API. Clique em Gmail API nos resultados e clique em Ativar. Aguarde a confirmação antes de continuar.

3. Volte para a Biblioteca. Pesquise por Google Docs API. Clique em Google Docs API e clique em Ativar.

4. Volte para a Biblioteca. Pesquise por Google Drive API. Clique em Google Drive API e clique em Ativar.

5. Confirme se todas as três APIs estão ativas acessando APIs e Serviços > APIs e serviços ativados. Todas as três devem aparecer na lista antes de prosseguir. Se alguma API estiver faltando, o fluxo de consentimento OAuth falhará.

Configurar a tela de consentimento do OAuth

1. Vá para APIs e Serviços > Tela de consentimento do OAuth.

2. Selecione Interno se a conta do Gmail dedicada pertencer a uma organização do Google Workspace. Isso restringe o acesso apenas aos usuários dentro da sua organização e é recomendado para ferramentas internas. Selecione Externo se estiver usando uma conta do Gmail pessoal. Aplicativos externos permanecem em modo de teste até serem publicados, o que limita usuários autorizados apenas à lista de usuários de teste.

3. Clique em Criar.

4. Na página Informações do app, preencha o campo Nome do app com Meeting Notes Agent. Insira um Email de suporte do usuário e pelo menos um endereço de Email de contato do desenvolvedor. Clique em Salvar e continuar.

5. Na página Escopos, clique em Adicionar ou remover escopos. Pesquise e adicione os seguintes escopos: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/documents.readonly e https://www.googleapis.com/auth/drive.readonly. Clique em Atualizar e depois em Salvar e continuar.

6. Se você selecionou Externo, aparecerá uma página Usuários de teste. Clique em Adicionar usuários e adicione o endereço de email da caixa de entrada do Gmail dedicada (por exemplo, meetingnotes@company.com). Clique em Adicionar e depois em Salvar e continuar.

7. Revise o resumo na tela final e clique em Voltar ao painel.

Criar o ID do cliente OAuth 2.0

1. Vá para APIs e Serviços > Credenciais. Clique em Criar credenciais na parte superior da página e selecione ID do cliente OAuth 2.0.

2. Em Tipo de aplicativo, selecione Aplicativo da Web. No campo Nome, insira um rótulo como Meeting Notes Agent - QA para facilitar a identificação em diferentes ambientes.

3. Role para baixo até a seção URIs de redirecionamento autorizados e clique em Adicionar URI. Insira o URI de redirecionamento anexando /oauth/callback à URL do serviço de API para a API personalizada. Esse valor é rotulado como URL base da API na guia Perfil da API no API Manager. O caminho deve ser exatamente /oauth/callback sem barra final. Qualquer incompatibilidade causa um erro redirect_uri_mismatch quando o fluxo do OAuth é executado.

4. Clique em Criar.

Copiar e armazenar as credenciais

Após clicar em Create, o Google exibe um diálogo mostrando o novo ID do cliente e o segredo do cliente. Copie ambos os valores imediatamente e armazene-os com segurança em um gerenciador de senhas ou cofre de segredos. O segredo do cliente é mostrado em sua totalidade apenas neste diálogo. Se você fechá-lo sem copiar, poderá regenerar o segredo posteriormente na página Credentials clicando em Edit na entrada de credencial, mas também deverá atualizar a variável de projeto client_secret com o novo valor. Clique em OK para fechar o diálogo após ambos os valores serem salvos.

Autorizar acesso do Gmail

Antes que o fluxo de trabalho de sondagem agendado seja executado, um administrador deve concluir uma autorização OAuth 2.0 única para a caixa de entrada dedicada do Gmail. Esta etapa armazena um token de atualização no armazenamento de chave Cloud Datastore AIA_Authorized_Users para uso em execuções agendadas subsequentes.

Para autorizar o acesso do Gmail:

1. Após implantar o projeto, acione a operação Handle Connect Gmail no fluxo de trabalho Gmail OAuth Authentication navegando até o endpoint da API /connect-gmail publicado pelo Jitterbit API Manager.
2. Conclua a tela de consentimento do Google para a conta dedicada do Gmail. O Google redireciona de volta para o endpoint de retorno de chamada da API Jitterbit com um código de autorização.
3. O agente troca o código de autorização por tokens de acesso e atualização, recupera o endereço do Gmail associado e armazena o token de atualização no armazenamento de chave Cloud Datastore AIA_Authorized_Users.
4. Confirme que a variável de projeto refresh_token foi preenchida ou que um registro aparece na coleção AIA_Authorized_Users antes que o fluxo de trabalho de sondagem agendado seja executado pela primeira vez.

Revisar fluxos de trabalho do projeto

O projeto do Studio contém seis fluxos de trabalho que implementam a funcionalidade do Meeting Notes Agent, organizados em dois grupos funcionais.

Autenticação e sondagem

Gmail OAuth Authentication

Este fluxo de trabalho manipula o fluxo de autorização OAuth 2.0 único para a caixa de entrada dedicada do Gmail. Um administrador navega até o endpoint da API /connect-gmail, que constrói a URL de autorização do Google e redireciona para a tela de consentimento do Google. Após o consentimento, o Google retorna um código de autorização ao endpoint de retorno de chamada da API Jitterbit. O fluxo de trabalho troca o código por tokens de acesso e atualização, recupera o endereço do Gmail associado ao token e armazena o token de atualização no armazenamento de chave Cloud Datastore AIA_Authorized_Users para reutilização em todas as execuções agendadas subsequentes.

Gmail Polling and Message Retrieval

Este fluxo de trabalho é executado em um cronograma de operação de 24 horas. Ele consulta o armazenamento de chave Cloud Datastore AIA_Authorized_Users para obter o token de atualização armazenado, troca-o por um token de acesso fresh do Gmail e busca na caixa de entrada do Gmail por e-mails de gemini-notes@google.com na janela de 24 horas anterior. Para cada mensagem encontrada, o fluxo de trabalho recupera a carga útil completa da mensagem, decodifica em Base64 o corpo, extrai a URL do Google Doc incorporada e analisa o ID do documento da URL. Cada ID de documento é então encaminhado para o fluxo de trabalho de extração de conteúdo e deduplicação.

Processamento de notas de reunião

Extração e Deduplicação de Conteúdo do Google Docs

Este workflow consulta o armazenamento de chaves Cloud Datastore AIA_Processed_Meetings para determinar se o ID do documento atual já foi processado. Se um registro correspondente existir, o workflow ignora o documento. Para novos documentos, o workflow escreve o ID do documento em AIA_Processed_Meetings com o valor processed, depois chama a API de exportação do Google Docs para recuperar o conteúdo do documento como texto simples. O texto extraído é analisado para identificar a lista de participantes e isolar o conteúdo entre os títulos Summary e Suggested next steps para processamento downstream do LLM.

Processamento OpenAI GPT-4o

Este workflow constrói um prompt a partir do conteúdo da nota de reunião extraída e o envia para a API do OpenAI. O prompt instrui o LLM a retornar um objeto JSON com as seguintes chaves: summary, next_steps e action_items (cada uma com os campos description, owner, due_date e priority). O workflow analisa a resposta de conclusão do chat, remove qualquer fence de código Markdown do bloco de conteúdo e itera sobre os itens de ação para preparar payloads por participante para os workflows do Salesforce e Slack.

Criação de Tarefas e Eventos no Salesforce

Este workflow processa cada proprietário de item de ação identificado na resposta do LLM. Para cada proprietário, o workflow resolve o email do participante a partir da lista de participantes extraída, depois executa uma consulta SOQL para recuperar o registro de Contato do Salesforce por endereço de email. Se a consulta retornar exatamente um contato correspondente, o workflow cria um registro de Task com a descrição do item de ação, uma prioridade mapeada a partir da resposta do LLM (High, Medium ou Low), uma data de vencimento originária da resposta do LLM (padrão de sete dias a partir da data atual se nenhuma for fornecida) e um status de Not Started. Também cria um registro de Event representando a reunião, com duração de 30 minutos e data e hora de atividade definidas para quando a operação é executada, vinculado ao mesmo contato. Se a consulta retornar zero ou mais de um contato correspondente, o item de ação é ignorado. Após os registros do Salesforce serem criados, o workflow dispara uma mensagem direta personalizada no Slack para o participante contendo o resumo da reunião e seus itens de ação individuais.

Consulta On-Demand do Copilot

Este workflow expõe um endpoint de API customizada do Jitterbit API Manager que aceita um parâmetro user_email no corpo da solicitação e reinicia o pipeline principal de processamento de notas de reunião para o usuário especificado.

Disparar os workflows do projeto

Após implantar o projeto, o workflow principal de processamento de notas de reunião é executado automaticamente em um agendamento de operação de 24 horas.

O workflow Gmail OAuth Authentication deve ser disparado manualmente uma vez por um administrador navegando até o endpoint da API customizada /connect-gmail antes que o workflow de polling agendado possa ser executado com êxito.

O workflow Copilot On-Demand Query é disparado por chamadas de API para o endpoint da API customizada /runmeetingnotes.

Solução de Problemas

Se encontrar problemas, analise os logs a seguir para obter informações detalhadas de solução de problemas:

• Logs de API
• Logs de operação

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