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 pela aba Project endpoints and connectors (Endpoints e conectores do projeto) da paleta de componentes de design (consulte Design component palette).

Visão geral do conector

Este conector é usado para configurar primeiro uma conexão OpenAI. Os tipos de atividade associados a essa conexão são então utilizados para criar instâncias de atividades destinadas a serem usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

Em conjunto, uma conexão OpenAI específica e suas atividades são referidas como um endpoint OpenAI:

• Create Transcription: Transcreve áudio em texto com base no idioma de entrada detectado no OpenAI e é destinado a ser usado como destino em uma operação.

• Register Tools (Deprecated): Adiciona ferramentas a um assistente no OpenAI e é destinado a ser usado como destino em uma operação.

  Aviso

  A atividade Register Tools (Deprecated) está descontinuada e não é mais suportada. Em uma versão futura, essa atividade será removida permanentemente. Ela foi substituída na versão 12.8 pela atividade Register Tools V2 redesenhada, cujo uso da API Responses do OpenAI possibilita persistir registros de ferramentas entre operações em grupos de agentes na nuvem, não apenas em agentes privados.

• Create Image: Cria imagens com base em um prompt especificado no OpenAI e é destinado a ser usado como destino em uma operação.

• Prompt V2: Cria uma resposta para o prompt fornecido usando a API Responses do OpenAI e é destinado a ser usado como destino em uma operação.

• Register Tools V2: Adiciona ferramentas a um assistente usando a API Responses do OpenAI e é destinado a ser usado como destino em uma operação.

• Register MCP Server Tools: Registra um servidor MCP remoto como provedor de ferramentas no OpenAI e é destinado a ser usado como destino em uma operação.

• Prompt (Deprecated): Cria uma conclusão de texto para o prompt fornecido no OpenAI e é destinado a ser usado como destino em uma operação.

  Aviso

  A atividade Prompt (Deprecated) está descontinuada e não é mais suportada. Em uma versão futura, essa atividade será removida permanentemente. Ela foi substituída na versão 12.8 pela atividade Prompt V2 redesenhada, cujo uso da API Responses do OpenAI possibilita persistir contexto de chat e chamar ferramentas registradas em grupos de agentes na nuvem, não apenas em agentes privados.

• Criar Atividade de Tradução: Traduz arquivos de áudio em texto em inglês na OpenAI e é destinado a ser usado como um destino em uma operação.

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.

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

Modelos OpenAI suportados

Este conector suporta estes modelos 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:

  • gpt-4.1
  • gpt-4.1-mini
  • gpt-4.1-nano

• Modelos GPT-5:

  • gpt-5
  • gpt-5-chat-latest
  • gpt-5-mini
  • gpt-5-nano

• 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.4
  • gpt-5.4-mini
  • gpt-5.4-nano

• GPT-5.5

• Modelos GPT-5.6:

  • gpt-5.6-sol
  • gpt-5.6-terra
  • gpt-5.6-luna

• GPT Image 2

• modelos da série o:

  • o1
  • o3
  • o3-mini
  • o4-mini-2025-04-16

• Whisper (whisper-1)

Solução de problemas

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

1. Clique no botão Testar na configuração de conexão para garantir que a conexão seja bem-sucedida e para garantir que a versão mais recente do conector seja baixada no agente (a menos que esteja usando a política organizacional Desabilitar Atualização Automática do Conector).

2. Verifique os logs de operação para qualquer informação registrada durante a execução da operação.

3. Ative o log de depuração de operação (para agentes em nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.

4. Se estiver usando agentes privados, você pode ativar o log 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 log detalhado do conector, consulte Log detalhado para conectores usando agentes privados Jitterbit.

5. Se estiver usando agentes privados, você pode verificar os logs do agente para mais informações.

6. Para considerações adicionais de solução de problemas, consulte Solução de problemas de operação.

Veja na prática

• Use OpenAI para processar dados em uma operação Studio: Construindo um prompt a partir de dados de origem, enviando-o para OpenAI e roteando a resposta da IA para um destino downstream.
• Processe documentos com IA: Extraindo dados estruturados de documentos não estruturados usando o conector OpenAI.
• Roteie respostas de LLM para operações Studio usando chamadas de função: Usando chamadas de função OpenAI para rotear dinamicamente a saída de LLM para diferentes operações Studio.