Ir para o conteúdo

Conector Azure OpenAI para Jitterbit Studio

Resumo

O conector Azure OpenAI estabelece acesso ao Azure OpenAI.

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

O conector Azure OpenAI é acessado na aba Endpoints e conectores do projeto do painel de componentes de design (veja Painel de componentes de design).

Visão geral do conector

Esse conector é usado para primeiro configurar uma conexão Azure 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 específica do Azure OpenAI e suas atividades são referidos como um endpoint Azure OpenAI:

Tipos de atividades do Azure OpenAI

  • Registrar Ferramentas: Adiciona ferramentas a um assistente de chatbot no Azure OpenAI e é destinado a ser usado como um alvo em uma operação.

  • Solicitar Imagem: Gera uma imagem com base em um prompt especificado no Azure 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 Azure OpenAI e é destinado a ser usado como um alvo em uma operação.

  • Baixar Imagem (obsoleto): Recupera a URL de uma imagem gerada anteriormente no Azure OpenAI e é destinado a ser usado como uma fonte em uma operação.

Nota

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

Os endpoints criados com este conector estão incluídos na reportagem de uso de endpoints e contam para sua licença.

Pré-requisitos e versões de API suportadas

O conector Azure 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.

Nota

O conector utiliza a Chat Completion API para todos os modelos, exceto gpt-35-turbo-instruct, que utiliza a Completions API legada. Essa mudança reflete as aposentadorias de modelos em andamento da Microsoft. Para mais informações, consulte aposentadorias de modelos do Azure OpenAI.

Dica

Siga estas diretrizes para gerenciar o histórico de chat entre operações:

  • Grupos de agentes na nuvem: Ative a opção Armazenar contexto de chat entre operações na configuração de conexão. O conector mantém o contexto da conversa entre operações dentro do mesmo ambiente usando o mesmo chatId (configurado na atividade Registrar Ferramentas).

  • Agentes privados: O contexto do chat é mantido na memória local para operações dentro da mesma cadeia de operações que compartilham o mesmo chatId.

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

O conector recupera a lista de modelos disponíveis do seu recurso Azure OpenAI quando você configura uma atividade. Apenas os modelos implantados em seu recurso Azure OpenAI aparecerão no menu de seleção ID do Modelo. Para informações sobre como implantar modelos, consulte a documentação da Microsoft.

Solução de Problemas

Se você encontrar problemas com o conector Azure OpenAI, as seguintes etapas de solução de problemas são recomendadas:

  1. 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).

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

  3. 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.

  4. 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.microsoft.azure.openai" level="DEBUG"/>

    Para mais informações sobre o registro detalhado do conector, consulte Registro 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.