Ir para o conteúdo

Conexão OpenAI no Jitterbit Studio

Introdução

Uma conexão OpenAI, criada usando o conector OpenAI, estabelece acesso ao OpenAI. Após configurar uma conexão, você pode criar instâncias de atividades OpenAI associadas a essa conexão para serem usadas como origens (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Criar ou editar uma conexão OpenAI

Uma nova conexão OpenAI é criada usando o conector OpenAI em um destes locais:

Uma conexão OpenAI existente pode ser editada nestes locais:

Configurar uma conexão OpenAI

Cada elemento da interface do usuário da tela de configuração da conexão OpenAI é descrito abaixo.

Dica

Campos com um ícone de variável permitem usar variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete de abertura [ no campo ou clique no ícone de variável para exibir um menu com as variáveis existentes disponíveis.

  • Connection name: Digite um nome para identificar a conexão. O nome deve ser único para cada conexão OpenAI e não pode conter barras / ou dois-pontos :. Este nome também é usado para identificar o endpoint OpenAI, que se refere tanto a uma conexão específica quanto às suas atividades.

  • API/Secret key: Digite a chave de API. As chaves de API são geradas na página API keys da instância OpenAI.

  • API version: A versão V1 é a única versão suportada e é selecionada por padrão.

  • Use Proxy Settings (Private Agent Only): Ao usar um agente privado, esta configuração pode ser selecionada para usar as configurações de proxy do agente privado para proxy HTTPS. Este conector não suporta proxy NTLM.

  • Optional settings: Clique para expandir configurações opcionais adicionais:

    • Organization ID: Digite o ID da organização para a instância OpenAI. Seu Organization ID pode ser encontrado na página Organization Settings.

    • Store chat context across operations (V2 activities only): Clique para ativar a memória de curto prazo que armazena o contexto do chat além do escopo de uma única operação.

      Importante

      Ativar esta configuração armazena o contexto do chat em cadeias de operações apenas para grupos de agentes na nuvem. Agentes privados sempre armazenam o contexto do chat na memória para operações dentro da mesma cadeia de operações que compartilham o mesmo chatId, independentemente desta configuração.

      Quando ativado, estas configurações adicionais são exibidas:

      • Chat context TTL: Digite o tempo de retenção do contexto do chat na memória de curto prazo em segundos. O valor padrão é 86400 segundos (1 dia).

  • Máximo de mensagens salvas no contexto: Digite o número máximo de mensagens a salvar no contexto de chat da memória de curto prazo. O valor padrão e mínimo é 10 mensagens.

  • Quando o contexto de chat não é encontrado: Selecione a ação a executar se o contexto de chat não for encontrado na memória de curto prazo:

    • Criar um novo contexto: (Padrão.) Um novo contexto de chat é criado.

    • Falhar na solicitação: A solicitação falha.

  • Testar: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta suspender o download da versão mais recente do conector usando a política organizacional Desabilitar Atualização Automática do Conector.

  • Salvar: Clique para salvar e fechar a configuração de conexão.

  • Descartar alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem solicita que você confirme que deseja descartar as alterações.

  • Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (consulte Dependências de componentes, exclusão e remoção). Uma mensagem solicita que você confirme que deseja excluir a conexão.

Próximas etapas

Após criar uma conexão OpenAI, coloque um tipo de atividade na tela de design para criar instâncias de atividade a serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

As ações de menu para uma conexão e seus tipos de atividade são acessíveis no painel do projeto e na paleta de componentes de design. Para detalhes, consulte Menus de ações em Noções básicas do conector.

Estes tipos de atividade estão disponíveis:

  • Criar Transcrição: Transcreve áudio em texto com base no idioma de entrada detectado no OpenAI e destina-se a ser usado como destino em uma operação.

  • Registrar Ferramentas (Descontinuado): Adiciona ferramentas a um assistente no OpenAI e destina-se a ser usado como destino em uma operação.

    Aviso

    A atividade Registrar Ferramentas (Descontinuado) está descontinuada e não é mais suportada. Em uma versão futura, esta atividade será removida permanentemente. Foi substituída na versão 12.8 pela atividade Registrar Ferramentas V2 redesenhada, cujo uso da API de Respostas do OpenAI permite persistir registros de ferramentas em operações em grupos de agentes na nuvem, não apenas em agentes privados.

  • Criar Imagem: Cria imagens com base em um prompt especificado no OpenAI e destina-se a ser usado como destino em uma operação.

  • Prompt V2: Cria uma resposta para o prompt fornecido usando a API de Respostas do OpenAI e destina-se a ser usado como destino em uma operação.

  • Registrar Ferramentas V2: Adiciona ferramentas a um assistente usando a API de Respostas do OpenAI e destina-se a ser usado como destino em uma operação.

  • Registrar Ferramentas do Servidor MCP: Registra um servidor MCP remoto como provedor de ferramentas no OpenAI e destina-se 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 um destino em uma operação.

    Aviso

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

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