Conector OpenAI no Jitterbit Studio

Resumo

O conector OpenAI estabelece acesso ao OpenAI.

O conector OpenAI fornece uma interface para criar uma conexão OpenAI, a base utilizada para gerar instâncias de atividades OpenAI. Essas atividades, uma vez configuradas, interagem com o OpenAI através da conexão.

O conector OpenAI é acessado na aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).

Visão geral do conector

Este conector é usado para primeiro configurar uma conexão OpenAI. Os tipos de atividades associados a essa conexão são então usados para criar instâncias de atividades que se destinam a ser usadas como fontes (para fornecer dados em uma operação) ou alvos (para consumir dados em uma operação).

Juntos, uma conexão OpenAI específica e suas atividades são referidos como um endpoint OpenAI:

Tipos de atividades OpenAI

Criar Transcrição: Transcreve áudio em texto com base no idioma detectado no OpenAI e é destinado a ser usado como um alvo em uma operação.
Registrar Ferramentas: Adiciona ferramentas a um assistente no OpenAI e é destinado a ser usado como um alvo em uma operação.
Criar Imagem: Cria imagens com base em um prompt especificado no OpenAI e é destinado a ser usado como um alvo em uma operação.
Prompt V2: Cria uma resposta para o prompt fornecido usando a API de Respostas do OpenAI e é destinado a ser usado como um alvo em uma operação.
Registrar Ferramentas V2: Adiciona ferramentas a um assistente usando a API de Respostas da OpenAI e é destinado a ser usado como um alvo em uma operação.
Registrar Ferramentas do Servidor MCP: Registra um servidor MCP remoto como um provedor de ferramentas com a OpenAI e é destinado a ser usado como um alvo em uma operação.
Prompt: Cria uma conclusão de texto para o prompt fornecido na OpenAI e é destinado a ser usado como um alvo em uma operação.
Criar Tradução: Traduz arquivos de áudio em texto em inglês na OpenAI e é destinado a ser usado como um alvo em uma operação.

Nota

Este conector é um conector baseado no SDK de Conectores, que pode ser referido pela Jitterbit ao comunicar alterações feitas em conectores construídos com o SDK de Conectores.

Os endpoints criados com este conector estão incluídos no relatório de uso de endpoints e contam para sua licença.

Pré-requisitos e versões de API suportadas

O conector OpenAI requer o uso de uma versão de agente 10.1 ou posterior. Essas versões de agente baixam automaticamente a versão mais recente do conector quando necessário.

Importante

Você deve usar um agente privado para a seguinte funcionalidade:

Para gerenciar o histórico de chat e manter o contexto da conversa entre chamadas de API.
Para usar a atividade Registrar Ferramentas.

O conector OpenAI utiliza a API OpenAI. Consulte a documentação da API para obter informações sobre os nós e campos do esquema.

Modelos OpenAI suportados

Este conector suporta estes modelos da OpenAI:

GPT-3.5 Turbo
Modelos GPT-4:
- gpt-4
- gpt-4-turbo
Modelos GPT-4o:
- gpt-4o
- gpt-4o-mini
Modelos GPT-4.1:
Modelos GPT-5:
Modelos GPT-5.1:
- gpt-5.1
- gpt-5.1-chat-latest
Modelos GPT-5.2:
- gpt-5.2
- gpt-5.2-chat-latest
Modelos GPT-5.3:
- gpt-5.3-chat-latest
Modelos GPT-5.4:
GPT-5.5
GPT Image 2
modelos o-series:
Whisper (whisper-1)

Solução de Problemas

Se houver problemas com o conector OpenAI, recomenda-se seguir estas etapas de solução de problemas:

Clique no botão Testar na configuração da conexão para garantir que a conexão seja bem-sucedida e que a versão mais recente do conector seja baixada para o agente (a menos que esteja usando a política de organização Desativar Atualização Automática do Conector).
Verifique os logs de operação para qualquer informação registrada durante a execução da operação.
Ative o registro de depuração da operação (para agentes em nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.
Se estiver usando agentes privados, você pode ativar o registro detalhado do conector para este conector adicionando esta entrada de configuração de logger ao arquivo logback.xml do seu agente privado:
```
<logger name="org.jitterbit.connector.openai" level="DEBUG"/>
```
Para mais informações sobre o registro detalhado do conector, consulte Registro detalhado para conectores usando agentes privados Jitterbit.
Se estiver usando agentes privados, você pode verificar os logs do agente para mais informações.
Para considerações adicionais de solução de problemas, veja Solução de problemas de operação.

Veja na prática

Use OpenAI para processar dados em uma operação do Studio: Construindo um prompt a partir de dados de origem, enviando-o para o OpenAI e direcionando a resposta da IA para um alvo a jusante.
Processe documentos com IA: Extraindo dados estruturados de documentos não estruturados usando o conector OpenAI.
Roteie respostas de LLM para operações do Studio usando chamada de função: Usando chamada de função do OpenAI para direcionar dinamicamente a saída do LLM para diferentes operações do Studio.