Ir para o conteúdo

Conexão Azure OpenAI

Introdução

Uma conexão Azure OpenAI, criada usando o conector Azure OpenAI, estabelece acesso ao Azure OpenAI. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades do Azure OpenAI associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Criar ou editar uma conexão Azure OpenAI

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

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

Configurar uma conexão Azure OpenAI

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

Configuração da conexão Azure OpenAI

Dica

Campos com um ícone variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir uma lista das 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 do Azure OpenAI e não deve conter barras / ou dois pontos :. Este nome também é usado para identificar o endpoint do Azure OpenAI, que se refere tanto a uma conexão específica quanto às suas atividades.

  • Endpoint: Insira o endpoint para o recurso do Azure OpenAI. Você pode encontrar o endpoint no Portal do Azure em Gerenciamento de Recursos > Chaves e Endpoint na barra lateral esquerda.

  • Chave de API/Segredo: Insira a chave de API para o recurso do Azure OpenAI. Você pode obter a chave de API no Portal do Azure em Gerenciamento de Recursos > Chaves e Endpoint na barra lateral esquerda. Você pode usar os valores dos campos CHAVE 1 ou CHAVE 2.

  • Configurações opcionais: Clique para expandir essas configurações opcionais:

  • Teste: 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 a suspensão do download da versão mais recente do conector usando a Desativar Atualização Automática do Conector política de organização.

  • 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 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 (veja Dependências de componentes, exclusão e remoção). Uma mensagem solicita que você confirme que deseja excluir a conexão.

Fontes de dados

Quando você habilita Adicionar uma fonte de dados na conexão, pode interagir com modelos do Azure OpenAI usando dados de uma Pesquisa AI do Azure ou de uma instância do Azure Cosmos DB para MongoDB (vCore).

Quando você seleciona Pesquisa AI do Azure como a fonte de dados, estes campos são exibidos:

Pesquisa AI do Azure

  • Selecionar uma fonte de dados: Use o menu para selecionar a Pesquisa AI do Azure.

    Nota

    Para informações sobre pré-requisitos do serviço de Pesquisa AI do Azure e criação de um serviço de Pesquisa AI do Azure, consulte a documentação da Microsoft.

  • Nome do serviço de pesquisa do Azure AI: Insira o Nome do serviço configurado para o seu serviço de pesquisa do Azure AI.

    Nota

    Você deve ter pelo menos a função de Contribuidor de Serviços Cognitivos para o recurso Azure OpenAI.

  • Selecione o tipo de autenticação do recurso Azure: A autenticação baseada em chave (API Key) é suportada e selecionada por padrão.

  • Chave da fonte de dados do serviço de pesquisa do Azure AI: Insira a Chave de administrador primária ou a Chave de administrador secundária. Você pode encontrar essas chaves na página Chave do seu serviço de pesquisa, em Configurações.

Azure Cosmos DB para MongoDB (vCore)

Quando você seleciona Azure Cosmos DB para MongoDB (vCore) como a fonte de dados, esses campos são exibidos:

Azure Cosmos DB para MongoDB (vCore)

  • Selecione uma fonte de dados: Use o menu para selecionar o Azure Cosmos DB para MongoDB (vCore).

  • String de conexão: Insira a string de conexão para o cluster do Azure Cosmos DB para MongoDB (vCore).

  • Nome do banco de dados: Insira o nome do banco de dados. Você configura o nome do banco de dados através de ferramentas MongoDB ou do código da sua aplicação.

  • Coleção do banco de dados: Insira o nome da coleção. Você configura o nome da coleção através de ferramentas MongoDB ou do código da sua aplicação.

Próximos passos

Após a criação de uma conexão com o Azure OpenAI, você coloca um tipo de atividade na tela de design para criar instâncias de atividade que serão 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 mais detalhes, veja Menus de ações em Conceitos básicos do conector.

Estes tipos de atividade estão disponíveis:

  • Registrar Ferramentas: Adiciona ferramentas a assistentes 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.