Nesta matéria
Onde: Configurações → Conteúdo e publicação → Suas contas de AI
Abra esta página: admin.<your-site>/settings/ai/providers (substitua <your-site> pelo endereço do seu site)
Antes de começar
- Uma conta no Azure com um recurso do Azure OpenAI criado.
- Pelo menos um modelo implantado (deployed) nesse recurso. O Azure só executa modelos após a implantação.
- Permissão para visualizar as chaves do recurso no Azure.
- Apenas membros que gerenciam AI podem fazer a conexão, e você deve ter feito login recentemente.
Passo a passo
- Abra o Portal do Azure e acesse o seu recurso do Azure OpenAI.
- Vá até Gerenciamento de Recursos e clique em Chaves e Ponto de Extremidade.
- Copie o Ponto de extremidade. Ele é parecido com
https://my-resource.openai.azure.com. O endereço deve terminar com.openai.azure.comou.cognitiveservices.azure.com. - Copie a CHAVE 1. Deixe a CHAVE 2 como reserva. Seu painel aceita chaves de 32 caracteres (letras de a–f e números) ou 84 caracteres.
- Localize os nomes dos seus deployments. No portal do Azure AI Foundry, abra Deployments no seu recurso. O nome do deployment é o nome que você definiu ao implantar o modelo. Ele pode ser diferente do nome original do modelo, por exemplo
gpt-4o-mini. - No painel do seu site, abra Configurações → Conteúdo e publicação → Suas contas de IA e localize o card do Azure OpenAI.
- Cole o Endpoint do Azure. Adicione cada deployment em Nomes das implantações e toque em Adicionar após cada um. Adicione pelo menos um.
- Cole a chave e toque em Testar e conectar. Você verá "Verificando sua chave…" e depois Conectado ✓.
Importante saber
- Você pode conectar até dois recursos do Azure.
- O Azure não envia uma lista de modelos por chave, então o painel exibe apenas os deployments que você digitou. Você pode adicionar outros depois se implantar mais modelos.
- Os preços são opcionais. Com os valores informados, o painel consegue exibir os custos. Sem eles, a AI não alterna para esta conta automaticamente se outra conta falhar.
- As cobranças são feitas pelo Azure. Acompanhe custos e orçamentos pelo Portal do Azure. Orçamento e limites de AI
- A chave de API fica salva apenas no seu servidor. A Keynate nunca tem acesso a ela.
Problemas comuns
Use seu endpoint do Azure OpenAI
O endpoint deve terminar com .openai.azure.com ou .cognitiveservices.azure.com. Copie o endereço em Chaves e Ponto de Extremidade. Domínios personalizados ou endereços IP não funcionam.
Este modelo ou deployment não está disponível na sua conta do Azure OpenAI
O nome do deployment não confere. Os nomes precisam ser exatamente iguais, incluindo letras maiúsculas e minúsculas. Confira em Deployments no Foundry, ajuste o nome no card e tente novamente.
O Azure OpenAI recusou esta chave
Copie a chave inteira novamente. As chaves pertencem a um recurso específico; utilize uma chave gerada pelo mesmo recurso do endpoint.
Não foi possível acessar este endereço
Verifique se o endpoint foi digitado corretamente. Se o seu recurso no Azure restringir o acesso a redes específicas, o teste pode falhar. Permita o acesso público ao recurso ou libere o IP do seu servidor e tente novamente.
O Azure informa que a cota ou o limite de requisições foi atingido
Aguarde um minuto ou aumente o limite de cota do deployment no painel do Azure.
Dúvidas frequentes
Perguntas frequentes
Qual chave devo usar, CHAVE 1 ou CHAVE 2?
Qualquer uma. Sugerimos usar a CHAVE 1. Caso você alterne as chaves no Azure, insira a nova chave usando Substituir chave.
Por que preciso digitar os nomes dos deployments?
O Azure permite que você dê o nome que quiser a cada deployment. Como o painel não tem como adivinhar esses nomes, você precisa indicar quais deles quer utilizar.