Fornecedores de IA
Registar os serviços de IA do tenant e escolher os modelos que as apps podem usar, com as credenciais cifradas no servidor.
Os scripts das apps chamam modelos de inteligência artificial pelo SDK dos scripts. Antes disso, um administrador regista os fornecedores: o serviço de IA, as credenciais de acesso e os modelos que as apps podem usar.
As credenciais ficam cifradas no servidor. Nunca chegam ao browser, ao código dos scripts, nem ao pacote de uma app exportada.
Nota
Os fornecedores são do tenant: valem para todas as apps. Cada app escolhe, nas definições dela, que modelos usa entre os autorizados aqui (ver Modelos de IA da app).
Onde estão
Abre Definições, no fundo da barra lateral, e escolhe Fornecedores no grupo Inteligência artificial. Só contas com perfil de administrador lá entram.
A lista mostra o nome de cada fornecedor, o tipo, a ligação (o endereço ou a região, nunca uma credencial) e quantos modelos estão autorizados.

Os tipos de fornecedor
| Tipo | O que se preenche | Notas |
|---|---|---|
| OpenAI | Chave de API; Organização e Projecto são opcionais | Os modelos da OpenAI. |
| Anthropic | Chave de API | Os modelos Claude. A Anthropic não tem modelos de embeddings. |
| Microsoft Foundry | Endereço do recurso e Chave de API | O nome de cada modelo é o nome da implementação no recurso. Os modelos Claude só funcionam num endereço services.ai.azure.com. |
| Amazon Bedrock | Região, ID da chave de acesso e Chave de acesso secreta | A chave IAM precisa de permissão para invocar os modelos. Para o teste listar os modelos, precisa também de bedrock:ListFoundationModels. |
| Google Cloud | Serviço: com a Gemini API, a Chave de API; com o Vertex AI, o Projecto do Google Cloud, a Localização e a Conta de serviço (JSON) | A conta de serviço precisa da função Vertex AI User. Os modelos Claude só funcionam pelo Vertex AI. |
| OpenRouter | Chave de API; Nome da aplicação é opcional | Modelos de vários fabricantes com uma só chave. |
| Compatível com OpenAI | Endereço base e, se o servidor a pedir, a Chave de API (opcional) | Ollama, LM Studio, vLLM e outros servidores com a API da OpenAI. |
Atenção
Num fornecedor Compatível com OpenAI, o endereço tem de ser alcançável
a partir do servidor da plataforma, não do computador de quem usa a app.
localhost é o próprio servidor da plataforma.
Criar um fornecedor
- Em Fornecedores, carrega em Novo fornecedor.
- Escolhe o Tipo. O tipo não muda depois de criado.
- Escreve o Nome. É por este nome que as apps escolhem o fornecedor: letras minúsculas, algarismos, hífen e underscore. Também não muda depois de criado.
- Preenche os campos da Ligação, que dependem do tipo.
- Carrega em Testar ligação, no cabeçalho. O teste usa o que está escrito, sem gravar nada, e diz se a ligação e a chave foram aceites. Quando o fornecedor tem uma lista de modelos, a lista aparece em Modelos autorizados.
- Em Modelos autorizados, marca os modelos que as apps podem usar, ou carrega em Acrescentar modelo e escreve o nome. Escolhe o uso de cada um: Texto, Embeddings, Imagens, Transcrição ou Voz. No Microsoft Foundry, escolhe também o formato: Formato OpenAI ou Formato Anthropic (Claude).
- Revê os Limites e carrega em Gravar.

As credenciais
- Escrevem-se e nunca voltam ao ecrã. O campo diz Definida — escreve para trocar ou Por definir.
- Deixar o campo vazio ao gravar mantém a credencial que lá está.
- Se mudares o endereço (o Endereço do recurso do Microsoft Foundry ou o Endereço base de um servidor compatível), a credencial gravada não segue para o endereço novo: tens de a escrever outra vez. Assim ninguém consegue mandar uma chave que não vê para um servidor seu.
- O registo de auditoria guarda que credenciais foram escritas, nunca o valor.
Os limites
- Tempo máximo (s): quanto tempo um pedido pode demorar, de 5 a 600 segundos (120 por omissão). Um modelo de raciocínio pode precisar de mais de um minuto.
- Pedidos em simultâneo: quantos pedidos a este fornecedor correm ao mesmo tempo, somando todas as apps (4 por omissão). Os outros esperam pela vez.
- Activo: desactivado, nenhum script consegue usar o fornecedor, e as credenciais ficam guardadas.

Editar e apagar um fornecedor
- Para editar, carrega no nome do fornecedor, ou no menu ⋮ da linha e em Editar.
- Para apagar, abre o menu ⋮ da linha e carrega em Remover. A confirmação aparece por cima da lista. As apps que usam o fornecedor deixam de conseguir chamar a IA até escolherem outro fornecedor.
Perguntas frequentes
O teste diz «Não foi possível ligar ao fornecedor» num servidor local. O endereço tem de ser alcançável a partir do servidor da plataforma. Confirma o endereço e a porta, e que o servidor aceita ligações de fora da máquina dele.
O teste do Microsoft Foundry não mostra modelos. No Foundry, os modelos que se chamam são as implementações do recurso, que a API não lista. O teste confirma a chave; escreve os nomes das implementações em Acrescentar modelo.
Quem consegue ver as chaves? Ninguém. O ecrã só diz se cada credencial está definida, os scripts nunca as recebem, e a exportação de uma app não as leva.