Guias práticos para Jitterbit Studio
Os guias práticos cobrem tarefas comuns e práticas no Studio com exemplos completos e funcionais. Enquanto a documentação de referência da Interface do Usuário e Design explica o que cada configuração, função e conector faz, estes guias mostram como construir implementações completas e funcionais diretamente em seu próprio projeto.
Por onde começar
Se você é novo no Studio ou procura pelos padrões mais amplamente aplicáveis, estes guias cobrem os fundamentos:
- Chamar uma API REST usando o conector HTTP v2: O padrão de uso geral para chamadas REST de saída quando nenhum conector dedicado existe para seu endpoint. Se um conector de aplicação está disponível para seu sistema, use-o primeiro.
- Encadear e controlar operações: Como vincular operações usando a ferramenta Invoke Operation ou scripts
RunOperation, com lógica condicional e tratamento de erros. - Configurar tratamento de erros em operações: Como definir ações de sucesso e falha, capturar erros e construir cadeias de operações resilientes.
- Gerenciar credenciais de endpoint: Práticas recomendadas para armazenar e referenciar chaves de API e credenciais com segurança usando variáveis de projeto.
Guias práticos do Studio
API e conectividade
- Autenticar endpoints de API usando JWT
- Construir strings de consulta dinâmicas para chamadas de API REST
- Chamar uma API REST usando o conector HTTP v2
- Expor uma operação do Studio como uma API REST
- Filtrar resultados de consulta de banco de dados usando parâmetros de solicitação de API
- Gerar uma assinatura HMAC-SHA256
- Lidar com paginação ao ler de uma API
- Implementar um fluxo de código de autorização OAuth 2.0 com armazenamento de token
- Gerenciar credenciais de endpoint
- Receber eventos do Slack em uma operação do Studio
- Reutilizar endpoints e scripts
- Suportar mensagens SOAP MTOM/XOP
- Acionador de uma operação do Studio a partir de um webhook
Manipulação de dados
- Detectar e desduplicar registros usando funções de hash
- Filtrar registros usando condições
- Lidar com arrays usando Get e Set
- Lidar com fusos horários em operações de data e hora
- Executar um upsert em massa em um banco de dados
- Preencher e usar um dicionário
- Processar registros incrementais usando uma marca d'água alta
- Ler um arquivo compactado e codificado em Base64
- Rotear mensagens XML por tipo de nó
- Configurar sincronização bidirecional entre dois sistemas
- Dividir um arquivo em registros individuais usando SCOPE_CHUNK
- Validar e enriquecer registros antes de um upsert de CRM
- Dividir um arquivo em registros individuais usando SourceInstanceCount
Operações e agendamento
- Configurar tratamento de erros em operações
- Configurar divisão de operações para grandes volumes de dados
- Gerenciar operações assíncronas
- Gerenciar fluxos de trabalho usando scripts de controlador
- Repetir uma operação com falha
- Agendar uma operação para execução automática
- Usar uma convenção de nomenclatura para variáveis
- Encadear e controlar operações
Notificações
- Gerar um log resumido após processar registros
- Enviar notificação por email de uma operação do Studio
- Enviar notificação do Microsoft Teams de uma operação do Studio
- Enviar notificação do Slack de uma operação do Studio
Padrões de IA
- Analisar arquivos usando entradas de arquivo do OpenAI
- Criar um chat LLM multiturno com histórico de conversa
- Conectar a um servidor MCP Jitterbit usando o conector MCP Client
- Conectar a um servidor MCP usando o conector MCP Client
- Implementar um loop de chamada de ferramentas LLM
- Processar documentos com IA
- Rotear respostas LLM para operações do Studio usando chamada de funções
- Usar Azure OpenAI em uma operação do Studio
- Usar OpenAI para processar dados em uma operação do Studio
Padrões de conectores
- Enriquecer dados de contato usando ZoomInfo
- Tratar mensagens com falha usando uma fila de letras mortas
- Publicar e receber mensagens do Google Pub/Sub
- Ler e analisar conteúdo do Google Docs
- Ler e escrever arquivos no Box
- Enviar e receber mensagens do Azure Service Bus
- Armazenar e recuperar estado da sessão usando Cloud Datastore
- Escrever dados em uma planilha do Google Sheets
- Mapear datas de origem para campos de data do Salesforce e registrar erros de resposta
- Consultar registros do Salesforce usando SOQL
- Sincronizar envios de formulários do HubSpot com o Salesforce
- Enviar registros de objetos do Salesforce alterados para um banco de dados via regra de fluxo de trabalho do Salesforce e API Manager
- Enviar registros de objetos do Salesforce alterados para um banco de dados via fluxo do Salesforce e API Manager
Guias práticos sobre agentes de IA
Estes guias cobrem a construção de agentes de IA completos na plataforma Jitterbit Harmony usando Studio, API Manager e App Builder em conjunto. Eles estão localizados na documentação Agentes de IA.
- Como criar um agente de IA reativo: Crie um agente básico que responda a consultas do usuário sem memória ou ferramentas, fornecendo a base para todos os padrões de agentes.
- Como criar um agente de IA contextual: Adicione memória de conversa a um agente reativo usando Cloud Datastore para armazenar e recuperar histórico entre turnos.
- Como criar um agente de IA com ferramentas RAG: Estenda um agente contextual com Geração Aumentada por Recuperação para consultar fontes de dados e melhorar a precisão das respostas.
- Como criar um agente de IA com MCP: Crie um agente usando o conector MCP Client para consumir ferramentas de um servidor Model Context Protocol.
- Como criar um agente composto: Direcione as consultas do usuário para múltiplos agentes especializados com base em análise de conteúdo.
- Como criar um agente de IA com ajuste fino de LLM: Treine um modelo OpenAI com dados da sua organização e use o modelo ajustado em um agente.
- Como criar uma aplicação inteligente: Integre um agente de IA exposto como API REST em uma aplicação App Builder.
Guias práticos sobre agentes
Estes guias cobrem tarefas de instalação, configuração e manutenção de agentes privados. Eles estão localizados na documentação Agentes.
- Migrar agentes
- Instalação personalizada do PostgreSQL no Windows
- Redefinir a senha do usuário administrador do PostgreSQL
- Alterar o método de criptografia de senha do PostgreSQL de MD5 para SCRAM
- Adicionar o certificado global DigiCert mais recente do Salesforce ao armazenamento de confiança
- Atualizações contínuas
Guias de configuração de conectores
Os guias de configuração de conectores cobrem como configurar o sistema externo para que o Jitterbit possa se conectar a ele, como configurar autenticação, criar campos obrigatórios ou habilitar recursos específicos no aplicativo de terceiros. Eles são diferentes dos guias práticos do Studio acima, que descrevem como criar e estruturar integrações no Studio (incluindo os padrões de conectores que usam um conector específico).
Estes guias estão localizados na documentação de cada conector.