Neste artigo
Onde: Definições → Conteúdo e publicação → As 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 Azure com um recurso Azure OpenAI.
- Pelo menos um modelo implementado nesse recurso. A Azure só executa um modelo depois de o implementar.
- Permissões para ler as chaves do recurso na Azure.
- Apenas os membros que gerem a AI podem ligar a conta, sendo necessário ter iniciado sessão recentemente.
Passo a passo
- Aceda ao portal do Azure e abra o seu recurso Azure OpenAI.
- Vá a Resource Management e, depois, a Keys and Endpoint.
- Copie o Endpoint. Tem o aspeto de
https://my-resource.openai.azure.com. Deve terminar em.openai.azure.comou.cognitiveservices.azure.com. - Copie a KEY 1. Guarde a KEY 2 como reserva. A sua administração aceita uma chave de 32 carateres (letras de a–f e números) ou de 84 carateres.
- Consulte os nomes das suas implementações. No portal Azure AI Foundry, abra Deployments no seu recurso. O nome da implementação é o nome que escolheu ao implementar o modelo. Pode ser diferente do nome original do modelo, por exemplo
gpt-4o-mini. - Na administração do seu site, abra Definições → Conteúdo e publicação → As suas contas de IA e localize o cartão Azure OpenAI.
- Cole o Endpoint do Azure. Adicione cada implementação em Nomes das implementações e toque em Adicionar a seguir a cada uma. Tem de adicionar pelo menos uma.
- Cole a chave e toque em Testar e ligar. Irá ver "A verificar a sua chave…" e depois Ligado ✓.
Informações úteis
- Pode ligar até dois recursos Azure.
- A Azure não fornece uma lista de modelos por chave, pelo que a administração só apresenta as implementações que introduzir. Poderá adicionar mais mais tarde se implementar novos modelos.
- Os preços são opcionais. Com preços definidos, a administração consegue calcular custos. Sem eles, a AI não muda automaticamente para esta conta se outra conta falhar.
- A faturação é da responsabilidade da Azure. Pode consultar os seus custos e limites no portal do Azure. Orçamento e limites de AI
- A chave fica guardada no seu próprio servidor. A Keynate nunca tem acesso a ela.
Problemas comuns
Use o seu endpoint do Azure OpenAI
O endpoint tem de terminar em .openai.azure.com ou .cognitiveservices.azure.com. Copie-o a partir de Keys and Endpoint. Um domínio personalizado ou um endereço IP não funcionam.
Este modelo ou implementação não está disponível na sua conta Azure OpenAI
O nome da implementação não coincide. Os nomes têm de coincidir com exatidão, incluindo maiúsculas e minúsculas. Verifique a secção Deployments no Foundry, corrija o nome no cartão e teste novamente.
O Azure OpenAI recusou esta chave
Copie novamente a chave completa. As chaves pertencem a um recurso específico, por isso utilize uma chave do mesmo recurso a que pertence o endpoint.
Não foi possível contactar este endereço
Verifique se existem erros de digitação no endpoint. Se o seu recurso apenas permitir redes específicas, o teste pode falhar. Permita o acesso público ao recurso ou adicione o endereço do seu servidor e teste novamente.
A Azure indica que o limite de quota ou de pedidos foi atingido
Aguarde um minuto ou aumente a quota da implementação na Azure.
Perguntas frequentes
Perguntas frequentes
Que chave devo utilizar, a KEY 1 ou a KEY 2?
Qualquer uma. Utilize a KEY 1. Se renovar chaves na Azure, cole a nova chave em Substituir chave.
Porque tenho de introduzir os nomes das implementações?
A Azure permite escolher um nome personalizado para cada implementação. Como a sua administração não consegue adivinhá-los, tem de indicar quais pretende utilizar.