# Azure OpenAI

Executar modelos de IA implantados no Azure. Confira os campos necessários, a obtenção das credenciais e o funcionamento na Zild.

Source: https://zild.ai/pt-BR/docs/apps/zild-admin/connector-azure-openai

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.



<table class="api-params"><thead><tr><th>Campo</th><th>Requisito para o fluxo</th></tr></thead><tbody><tr><td><code>ApiKey</code></td><td>Chave de API do provedor.</td></tr><tr><td><code>Url</code></td><td>Endpoint HTTPS do recurso Azure OpenAI.</td></tr><tr><td><code>AssistantId / modelo do agente</code></td><td>Nome do deployment/modelo utilizado pelo fluxo; o modelo do agente pode substituir o valor padrão do conector.</td></tr></tbody></table>



## 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.

## Documentação oficial

- [Microsoft: resource keys and endpoints](https://learn.microsoft.com/en-us/azure/ai-services/authentication)

[Voltar a Conectores](/pt-BR/docs/apps/zild-admin/integration)