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. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades OpenAI associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

Criar ou editar uma conexão OpenAI

Uma nova conexão OpenAI é criada usando o conector OpenAI a partir de uma destas localizações:

Uma conexão OpenAI existente pode ser editada a partir destas localizações:

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 suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete quadrado aberto [ no campo ou clicando no ícone de variável para exibir um menu listando as variáveis existentes para escolher.

  • Nome da conexão: Insira um nome para identificar a conexão. O nome deve ser exclusivo para cada conexão OpenAI e não deve 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.

  • Chave API/Segredo: Insira a chave API. As chaves API são geradas na página de chaves API da instância OpenAI.

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

  • Usar Configurações de Proxy (Apenas Agente Privado): 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.

  • Configurações Opcionais: Clique para expandir configurações opcionais adicionais:

    • ID da Organização: Insira o ID da organização para a instância OpenAI. Seu ID da Organização pode ser encontrado na página de Configurações da Organização.

    • Armazenar contexto de chat entre operações (apenas atividades V2): Clique para ativar a memória de curto prazo que armazena o contexto de chat além do escopo de uma única operação.

      Importante

      Ativar esta configuração armazena o contexto de chat entre cadeias de operações apenas para grupos de agentes em nuvem. Agentes privados sempre armazenam o contexto de 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, essas configurações adicionais são exibidas:

      • TTL do contexto de chat: Insira o tempo em segundos para reter o contexto de chat na memória de curto prazo. O valor padrão é 86400 segundos (1 dia).

      • Número máximo de mensagens salvas no contexto: Insira o número máximo de mensagens a serem salvas 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 ser tomada 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 a 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 Desativar Atualização Automática do Conector política organizacional.

  • Salvar Alterações: Clique para salvar e fechar a configuração da 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 pede para confirmar que você 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 (veja Dependências de componentes, exclusão e remoção). Uma mensagem pede para confirmar que você deseja excluir a conexão.

Próximos passos

Depois que uma conexão OpenAI foi criada, você coloca 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 alvos (para consumir dados em uma operação).

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

Estes tipos de atividade estão disponíveis:

  • Criar Transcrição: Transcreve áudio em texto com base no idioma detectado na 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 do 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 o OpenAI e é destinado a ser usado como um alvo em uma operação.

  • Prompt: Cria uma conclusão de texto para o prompt fornecido no 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 no OpenAI e é destinado a ser usado como um alvo em uma operação.