Guias de como fazer para o Jitterbit Studio
Guias de como fazer cobrem tarefas práticas comuns 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, esses 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 está procurando os padrões mais amplamente aplicáveis, esses 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 não existe um conector dedicado para seu endpoint. Se um conector de aplicativo estiver disponível para seu sistema, use-o primeiro.
- Encadear e controlar operações: Como vincular operações usando a ferramenta Invocar Operação ou scripts
RunOperation, com lógica condicional e tratamento de erros. - Configurar o 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: Melhores práticas para armazenar e referenciar chaves de API e credenciais de forma segura usando variáveis de projeto.
Guias de como fazer 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
- 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
- Acionar uma operação do Studio a partir de um webhook
Manipulação de dados
- Detectar e deduplicar registros usando funções hash
- Filtrar registros usando condições
- Manipular arrays usando Get e Set
- Lidar com fusos horários em operações de data e hora
- Executar um upsert em massa para um banco de dados
- Preencher e usar um dicionário
- Processar registros incrementais usando um high-watermark
- Ler um arquivo compactado codificado em Base64
- Configurar sincronização bidirecional entre dois sistemas
- Dividir um arquivo em registros individuais usando SCOPE_CHUNK
- Validar e enriquecer registros antes de um upsert no 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 conjuntos de dados
- Gerenciar operações assíncronas
- Gerenciar fluxos de trabalho usando scripts de controle
- Repetir uma operação falhada
- Agendar uma operação para ser executada automaticamente
- Usar uma convenção de nomenclatura para variáveis
- Encadear e controlar operações
Notificações
- Gerar um log de resumo após processar registros
- Enviar uma notificação por e-mail a partir de uma operação do Studio
- Enviar uma notificação do Microsoft Teams a partir de uma operação do Studio
- Enviar uma notificação do Slack a partir de uma operação do Studio
Padrões de IA
- Analisar arquivos usando entradas de arquivo do OpenAI
- Construir um chat LLM de múltiplas interações com histórico de conversação
- Conectar-se a um servidor MCP usando o conector MCP Client
- Implementar um loop de chamada de ferramenta LLM
- Processar documentos com IA
- Roteirizar respostas LLM para operações do Studio usando chamada de função
- Usar Azure OpenAI em uma operação do Studio
- Usar OpenAI para processar dados em uma operação do Studio
Padrões de Conector
- Enriquecer dados de contato usando ZoomInfo
- Gerenciar mensagens falhadas usando uma Fila de Mensagens Mortas
- Publicar e receber mensagens do Google Pub/Sub
- Ler e analisar o conteúdo do Google Docs
- Ler e escrever arquivos no Box
- Enviar e receber mensagens do Azure Service Bus
- Armazenar e recuperar o estado da sessão usando o 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 de como usar agentes de IA
Esses guias abordam a construção de agentes de IA completos na plataforma Jitterbit Harmony usando o Studio, API Manager e App Builder juntos. Eles estão localizados na documentação de agentes de IA.
- Como construir um agente de IA reativo: Construa um agente básico que responde a consultas de usuários sem memória ou ferramentas, fornecendo a base para todos os padrões de agentes.
- Como construir um agente de IA contextual: Adicione memória de conversa a um agente reativo usando o Cloud Datastore para armazenar e recuperar o histórico entre as interações.
- Como construir 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 construir um agente de IA com MCP: Construa um agente usando o conector MCP Client para consumir ferramentas de um servidor do Protocolo de Contexto de Modelo.
- Como construir um agente composto: Roteie consultas de usuários para múltiplos agentes especializados com base na análise de conteúdo.
- Como construir um agente de IA com ajuste fino de LLM: Treine um modelo OpenAI com os dados da sua organização e use o modelo ajustado em um agente.
- Como construir uma aplicação inteligente: Incorpore um agente de IA exposto como uma API REST em uma aplicação do App Builder.
Guias de como usar agentes
Esses guias abordam tarefas de instalação, configuração e manutenção para agentes privados. Eles estão localizados na documentação de 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 da senha do PostgreSQL de MD5 para SCRAM
- Adicionar o último certificado global DigiCert da Salesforce ao armazenamento de confiança
- Atualizações contínuas
Guias de configuração do conector
Os guias de configuração do conector abordam como configurar o sistema externo para que o Jitterbit possa se conectar a ele, como configurar a autenticação, criar campos necessários ou habilitar recursos específicos no aplicativo de terceiros. Eles são diferentes dos guias de como fazer do Studio acima, que descrevem como construir e estruturar integrações no Studio (incluindo os padrões de conector que utilizam um conector específico).
Esses guias estão localizados na documentação de cada conector.