Agente Jitterbit QBR Deck

Visão Geral

A Jitterbit fornece o Agente QBR Deck aos clientes através do Jitterbit Marketplace. Este agente automatiza a criação de apresentações de revisão de negócios trimestral (QBR) no Google Slides, reunindo dados dos clientes do Salesforce, NetSuite e APIs de uso de produtos, e processando esses dados com IA para produzir resumos e insights estruturados. Este agente utiliza a técnica de Geração Aumentada por Recuperação (RAG), que combina o raciocínio de LLM com acesso a ferramentas externas e fontes de dados.

O agente recebe solicitações através de comandos de barra do Slack, consulta o Salesforce para detalhes de contas, contatos e casos de suporte, recupera dados de projetos do NetSuite e extrai métricas de uso de produtos de APIs regionais. Um LLM processa os dados combinados e gera resumos narrativos e insights. O agente então duplica um modelo de slides do Google Slides no Google Drive, preenche os slides com o conteúdo gerado e envia o link do deck completo (ou uma notificação de erro) de volta ao usuário no Slack.

O agente realiza as seguintes tarefas:

• Recebe solicitações de geração de QBR dos usuários via comandos de barra do Slack.
• Consulta o Salesforce para informações de conta, detalhes da região, contatos e casos de suporte.
• Recupera dados de projetos do NetSuite.
• Extrai métricas de uso de produtos de APIs regionais de uso de produtos.
• Normaliza todos os dados coletados em um formato canônico para processamento.
• Envia os dados combinados para um LLM gerar resumos e insights.
• Duplica um modelo de slide de QBR no Google Drive para o cliente-alvo.
• Preenche os slides com conteúdo gerado por IA.
• Envia o link do deck completo ou uma notificação de erro de volta ao usuário no Slack.

Este documento explica como configurar e operar este agente de IA. Ele cobre arquitetura, 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 gera apresentações de QBR orquestrando a recuperação de dados através das APIs do Salesforce, NetSuite e uso de produtos, e então utiliza um LLM para sintetizar os dados em uma apresentação do Google Slides preenchida. Uma interação típica segue estas etapas:

1. Um usuário envia um comando de barra /completeqbr para o bot do Slack, especificando um nome de cliente ou ID de conta do Salesforce.
2. O Slack chama o endpoint da API do Jitterbit, acionando o manipulador principal de solicitações.
3. O agente consulta o Salesforce em busca de informações da conta, detalhes da região, contatos e casos de suporte.
4. O agente recupera dados de projetos do NetSuite.
5. O agente obtém métricas de uso de produtos da API de uso de produtos regional apropriada.
6. O agente normaliza todos os dados coletados em um formato canônico.
7. O agente envia os dados normalizados para o LLM, que gera resumos e insights para cada seção do slide.
8. O agente duplica o modelo de QBR do Google Slides no Google Drive e preenche cada slide com o conteúdo gerado.
9. O agente envia o link da apresentação concluída para o usuário no Slack. Se ocorrer um erro (por exemplo, se o cliente não for encontrado ou se várias correspondências forem retornadas), o agente envia uma notificação de erro em vez disso.

Diagrama de fluxo de trabalho

O diagrama a seguir mostra o fluxo de trabalho principal de manipulação de solicitações para o Agente de QBR do Jitterbit.

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
• Agente de QBR adquirido como um 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 utiliza Azure OpenAI como o 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.

Salesforce

O agente consulta Salesforce para dados de conta, detalhes da região, contatos e casos de suporte. É necessário ter uma conta do Salesforce com acesso à API e credenciais com permissões para ler registros de conta, contato e caso.

NetSuite

O agente consulta NetSuite usando integração baseada em SOAP para recuperar dados de projetos. É necessário ter uma conta do NetSuite com credenciais de autenticação baseadas em token que tenham permissões para ler registros de projetos.

APIs de uso do produto

O agente recupera métricas de uso do produto de endpoints de API regionais cobrindo América do Norte (NOAM), Europa/Médio Oriente/África (EMEA) e Ásia-Pacífico (APAC). É necessário ter chaves de API válidas para as regiões aplicáveis.

Slack

O agente utiliza Slack como a interface de conversação e canal de notificações. É necessário ter um espaço de trabalho do Slack onde você possa instalar um aplicativo personalizado e a capacidade de criar e configurar um manifesto de aplicativo.

Google Cloud

O agente utiliza a API do Google Drive e a API do Google Slides para duplicar um modelo e preencher a apresentação gerada. É necessário ter um projeto do Google Cloud com ambas as APIs habilitadas e uma conta de serviço com acesso de Editor à Unidade Compartilhada que contém o modelo QBR e as pastas de saída.

Comandos do agente

O Agente do QBR Deck recebe todas as solicitações como comandos de barra enviados ao bot do Slack. Esta seção descreve os comandos suportados e fornece exemplos de entradas.

Diretrizes de prompt

Siga estas diretrizes ao enviar comandos para o agente:

• Especifique um cliente usando o parâmetro customer= seguido pelo nome do cliente ou ID da conta Salesforce.
• Se o nome corresponder a mais de uma conta Salesforce, o agente retornará um erro. Use o ID da conta Salesforce para direcionar um registro específico.
• Use /completeqbr para gerar um deck completo de apresentação QBR.
• Use /singleslideqbr para gerar um único slide. Use os parâmetros customer= e slide= para especificar o cliente e qual slide gerar.

Exemplos de comandos

Os seguintes exemplos mostram os comandos que o agente suporta. Substitua <customer name> pelo nome do cliente ou ID da conta Salesforce.

Deck completo de QBR

Envie o seguinte comando para gerar um deck completo de apresentação QBR para um cliente.

Slide único de QBR

Envie o seguinte comando para gerar um único slide para um cliente. O parâmetro slide= aceita os seguintes valores: title_1, Summary_1, Usage_1, Cases_1, Entitlements_1, Projects_1, ou team_1.

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 Azure OpenAI
3. Configurar o Google Cloud
4. Preparar o Google Drive
5. Configurar variáveis do projeto
6. Testar conexões
7. Implantar o projeto
8. Criar uma API personalizada
9. Criar e configurar o aplicativo Slack
10. Revisar fluxos de trabalho do projeto
11. Acionar 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 QBR Deck 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 aos 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 agente é exibido em vez disso. Clique nele para abrir uma caixa de diálogo informativa e, em seguida, clique em Enviar para que um representante entre em contato com você sobre a compra do agente de IA.

   Dica

   A caixa de diálogo de configuração inclui um aviso para não importar o modelo antes de aplicar as personalizações de endpoint. Esse aviso não se aplica a este agente de IA e pode ser ignorado. Siga a ordem recomendada de etapas nesta documentação.

5. Na etapa de configuração 1, Baixar Personalizações, baixe o arquivo ZIP fornecido contendo a estrutura de pastas do Google Drive e o modelo de slides do QBR.

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 de Projetos do Studio.

Configurar Azure OpenAI

Crie um recurso Azure OpenAI e implante um modelo para usar como o LLM para o agente:

1. Faça login no portal Azure e crie um recurso Azure OpenAI em sua assinatura.
2. No Azure AI Foundry, crie uma implantação e anote o nome da implantação e o ID do modelo.
3. Copie a chave da API e a URL do endpoint da seção Chaves e Endpoint do recurso.
4. Armazene a chave, o endpoint e os detalhes da implantação nas variáveis de projeto correspondentes listadas em Azure OpenAI.

Configurar o Google Cloud

Crie uma conta de serviço do Google Cloud para permitir que o agente acesse o Google Drive e o Google Slides:

1. Acesse console.cloud.google.com, selecione ou crie um projeto e ative a API do Google Drive e a API do Google Slides em APIs e Serviços > Biblioteca.
2. Vá para IAM e Admin > Contas de Serviço e crie uma nova conta de serviço.
3. Na aba Chaves, clique em Adicionar Chave > Criar nova chave, selecione JSON e baixe o arquivo de chave gerado.
4. Do arquivo JSON baixado, extraia os valores client_email, private_key e project_id e armazene-os nas variáveis de projeto correspondentes listadas em Google Cloud.
5. Defina a variável Google_OAuth_Scopes como https://www.googleapis.com/auth/drive.

Preparar o Google Drive

Faça o upload do modelo QBR para um Drive Compartilhado e conceda acesso à conta de serviço:

1. No Google Drive, certifique-se de que o destino seja um Drive Compartilhado (não uma pasta pessoal Meu Drive).
2. Conceda à conta de serviço (o valor de Google_Client_Email) acesso de Editor ao Drive Compartilhado.
3. Faça o upload do arquivo ZIP baixado em Baixar e instalar o projeto para o Drive Compartilhado e extraia seu conteúdo. Verifique se duas pastas foram criadas: Novos Documentos e Modelo QBR.
4. Abra a pasta Modelo QBR, localize o arquivo de modelo do Google Slides e copie o ID do arquivo do modelo da URL (a longa string entre /d/ e /edit).
5. Abra a pasta Novos Documentos e copie o ID da pasta da URL (a string após /folders/).
6. Armazene ambos os IDs nas variáveis de projeto Google_Drive_Template_File_Id e Google_Drive_Destination_Folder.

Configurar variáveis de projeto

No projeto do Studio instalado a partir 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 Variáveis do Projeto para abrir a gaveta de configuração.

Salesforce

NetSuite

Google Cloud

Product usage APIs

Azure OpenAI

Testar conexões

Testar 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

Implantar o projeto do Studio.

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

Criar uma API personalizada

Crie uma API personalizada no Jitterbit API Manager para expor o ponto de entrada do agente:

1. No API Manager, crie uma nova API personalizada com um método POST no caminho /newqbr.
2. Defina o gatilho da operação para a operação Manipulador de Solicitações da API no fluxo de trabalho 1.0 Entrada Principal – Manipulador de Solicitações da API do Slack.
3. Publique a API e copie a URL do endpoint gerado.
4. Use esta URL para os espaços reservados {{Jitterbit API for complete QBR Report}} e {{Jitterbit API for Partial QBR Report}} ao configurar o manifesto do aplicativo Slack. Apenas uma API é necessária; ambos os comandos de barra usam o mesmo endpoint.

Criar e configurar o aplicativo Slack

Crie um aplicativo Slack e configure-o para chamar o endpoint da API Jitterbit:

1. Vá para api.slack.com/apps e selecione ou crie seu aplicativo Slack.
2. Navegue até Manifesto do Aplicativo no menu à esquerda e clique em Editar Manifesto.
3. Cole o JSON do manifesto fornecido com o projeto no editor.
4. Substitua os espaços reservados {{Jitterbit API for complete QBR Report}} e {{Jitterbit API for Partial QBR Report}} pela mesma URL do endpoint da API Jitterbit criada em Criar uma API personalizada. Ambos os comandos de barra usam o mesmo endpoint; o agente os roteia internamente com base no nome do comando.
5. Clique em Salvar Alterações para aplicar a configuração.
6. Instale ou reinstale o aplicativo em seu espaço de trabalho, se solicitado.

Revisar fluxos de trabalho do projeto

O projeto Studio contém nove fluxos de trabalho que implementam a funcionalidade do Agente QBR Deck, organizados em dois grupos funcionais.

Entrada principal e lógica de IA

1.0 Entrada Principal – Manipulador de Solicitações da API Slack

Este fluxo de trabalho serve como o controlador central para o agente. Ele recebe solicitações de comando slash do Slack via o endpoint da API Jitterbit, valida a entrada e direciona as solicitações para os fluxos de trabalho de coleta de dados apropriados. Após a coleta de dados, coordena as operações pós-resposta e orquestra os passos de processamento de IA e geração de slides.

8.0 Principal – Lógica das Ferramentas do Agente de IA

Este fluxo de trabalho executa a lógica central de processamento de IA. Ele constrói a carga útil da solicitação a partir dos dados normalizados, envia para o LLM e processa os resumos e insights retornados. O conteúdo gerado é então passado para os fluxos de trabalho do Google Slides para inserção na apresentação.

Fluxos de trabalho de utilidade e ferramentas

2.0 Utilitário – Duplicar Modelo do Google Slides

Este fluxo de trabalho gerencia modelos. Ele se autentica com o Google Cloud usando um token OAuth, recupera o arquivo de modelo QBR configurado do Google Drive, cria uma cópia do modelo, atribui um novo ID de arquivo e o move para a pasta de destino configurada.

3.0 Utilitário – Google Slides

Este fluxo de trabalho gerencia atualizações de conteúdo dos slides. Ele modifica os títulos dos slides, o conteúdo do corpo e os resumos, recupera os metadados da apresentação, lida com o mapeamento de espaços reservados e realiza atualizações finais para garantir que todos os slides reflitam as percepções geradas pela IA.

4.0 Ferramenta – Manipulador de Entrada Canônica

Este fluxo de trabalho padroniza os dados de solicitação recebidos. Ele carrega e normaliza dados de várias fontes em um formato canônico unificado, garantindo consistência antes que os dados sejam passados para o fluxo de trabalho de processamento da IA.

5.0 Utilitário – Salesforce

Este fluxo de trabalho integra dados do Salesforce ao fluxo de trabalho. Ele consulta contas pelo nome ou ID da conta do Salesforce, recupera detalhes da região e busca contatos relacionados e casos de suporte para fornecer contexto de CRM para o QBR.

6.0 Utilitário – NetSuite

Este fluxo de trabalho recupera dados relacionados a projetos do NetSuite. Ele pesquisa e retorna registros de projetos para enriquecer o QBR com contexto operacional ou financeiro.

7.0 Utilitário – AskJBSales

Este fluxo de trabalho lida com análises de uso de produtos. Ele recupera dados de uso de produtos dos pontos de extremidade da API regional configurados, constrói conjuntos de dados de uso estruturados e combina várias respostas da API nos dados utilizados pelo fluxo de trabalho de processamento da IA.

9.0 Utilitário – Slack

Este fluxo de trabalho lida com comunicação de saída do Slack. Ele envia mensagens formatadas para o Slack, entregando o link do deck concluído, atualizações de status ou notificações de erro para o usuário que acionou a solicitação.

Acionar os fluxos de trabalho do projeto

O Agente QBR Deck é acionado por comandos de barra do Slack enviados para o aplicativo Slack configurado. Quando um usuário envia um comando /completeqbr ou /singleslideqbr, o Slack chama o endpoint da API Jitterbit, que aciona a operação API Request Handler no fluxo de trabalho 1.0 Main Entry – Slack API Request Handler.

Antes que o agente possa receber comandos, o aplicativo Slack deve ser instalado em seu espaço de trabalho e as URLs dos endpoints da API devem ser configuradas no manifesto do aplicativo. Veja Criar e configurar o aplicativo Slack e Criar uma API personalizada.

Solução de Problemas

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

• Logs da API
• Logs de Operação

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