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:
- A aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).
- A página Endpoints Globais (veja Criar um endpoint global em Endpoints Globais).
Uma conexão Azure OpenAI existente pode ser editada a partir dessas localizações:
- A aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).
- A aba Componentes do painel do projeto (veja Menu de ações do componente em Aba Componentes do painel do projeto).
- A página Endpoints Globais (veja Editar um endpoint global em Endpoints Globais).
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.
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:
-
Adicionar uma fonte de dados: Selecione esta opção para interagir com modelos do Azure OpenAI usando dados da sua fonte de dados. Quando você seleciona esta opção, campos adicionais aparecem com base na sua fonte de dados selecionada. Veja Fontes de dados para descrições das seguintes opções:
-
Usar Configurações de Proxy (Apenas Agente Privado): Ao usar um agente privado, esta configuração pode ser selecionada para usar configurações de proxy do agente privado.
-
-
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).
Pesquisa AI do Azure
Quando você seleciona Pesquisa AI do Azure como a fonte de dados, estes campos são exibidos:
-
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:
-
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.