Azure OpenAI
Executar modelos de IA implantados no Azure. Confira os campos necessários, a obtenção das credenciais e o funcionamento na Zild.
Executar modelos de IA implantados no Azure.
Onde configurar
Abra Zild Admin → Integrações → Conectores, localize o provedor e use Configurar ou Editar. Informe os dados deste guia, habilite o conector para o fluxo e salve.
Campos necessários
Os requisitos abaixo são os dados necessários ao fluxo que utiliza o conector. O cadastro genérico pode aceitar campos vazios que serão exigidos somente ao executar uma operação. O botão Salvar não confirma que a credencial funciona no provedor.
| Campo | Requisito para o fluxo |
|---|---|
ApiKey | Chave de API do provedor. |
Url | Endpoint HTTPS do recurso Azure OpenAI. |
AssistantId / modelo do agente | Nome do deployment/modelo utilizado pelo fluxo; o modelo do agente pode substituir o valor padrão do conector. |
Como obter as credenciais
- No portal Azure, crie ou abra o recurso do serviço correspondente.
- Abra Gerenciamento de recursos → Chaves e ponto de extremidade (Keys and Endpoint).
- Copie KEY1 ou KEY2 para ApiKey e o endpoint do mesmo recurso para Url, quando solicitado.
- No Microsoft Foundry, abra os deployments e copie o nome da implantação usada pelo agente. Não confunda esse nome com a chave.
Como funciona na Zild
A implementação instancia AzureOpenAIClient com Url e ApiKey e seleciona o deployment. O campo AssistantId serve como padrão de modelo em fluxos que o consultam.
Como conferir a configuração
Depois de salvar, use o fluxo correspondente (consulta, agente, chamada ou processamento) para verificar o acesso. Se houver erro, confira credencial, permissões e recurso escolhido no provedor. Para tipos limitados ou legados, confirme a disponibilidade com a administração antes de tentar usar.
Na edição, a Zild mostra credenciais protegidas como asteriscos. Preserve o valor mascarado para manter a credencial atual ou cole uma nova credencial para substituí-la.