Modelos de IA

Configuração

Dica

A aba Modelos de IA concentra a configuração do provedor de IA padrão da organização e do modelo que será utilizado pelos agentes e pelo Playground.

O que é configurado aqui

Campo	Descrição
Provedor de IA Padrão	Integração LLM ativa da organização que será utilizada por padrão (ex: Azure OpenAI, OpenAI, OpenRouter, Prodgy.AI)
Modelo de IA Padrão	Nome do modelo (completion) que o provedor deve utilizar — ex: gpt-4o, claude-sonnet-4-6

---

Provedor de IA Padrão

O seletor exibe apenas integrações com classificação LLM e status ativo instaladas na organização. Para aparecer nessa lista, a integração precisa estar previamente instalada em Integrações.

Quando um provedor é selecionado, o campo Modelo de IA Padrão carrega automaticamente o valor de completion salvo nas configurações dessa integração.

Nota

O provedor padrão também é utilizado pela Base de Conhecimento para gerar os embeddings dos documentos importados. Escolha uma integração LLM compatível com geração de embeddings.

---

Modelo de IA Padrão

Campo de texto livre para definir o nome exato do modelo no provedor — por exemplo: gpt-4o, gpt-4o-mini, claude-sonnet-4-6, llama-3.3-70b, ou qualquer deployment/alias configurado no provedor.

O campo só fica habilitado quando um provedor estiver selecionado. Ao salvar, o valor é persistido diretamente nas configurações da integração (não na organização) — ou seja, a próxima vez que você trocar de provedor e voltar, o modelo anterior continua associado àquela integração.

Cuidado

Se o provedor selecionado não tiver um modelo definido, o Playground bloqueia o envio de mensagens e exibe um aviso guiando a configuração desta tela.

---

Salvando Alterações

O botão Salvar fica habilitado apenas quando há mudanças pendentes no provedor ou no nome do modelo. Ao salvar, o Prodgy executa em sequência:

1. Se o provedor mudou, atualiza a organização com o novo default_model_id.
2. Se o modelo mudou, atualiza as configurações da integração base escolhida com o novo completion.

A mensagem de sucesso é exibida ao final e o Playground passa a refletir a nova configuração (veja o badge de provedor e modelo no rodapé da tela principal do Playground).

---

Casos de Uso

• Trocar de provedor sem perder contexto: selecione outra integração LLM no primeiro campo — o campo de Modelo carrega o completion salvo naquela integração. Basta ajustar se necessário e salvar.
• Atualizar apenas o modelo: com o provedor já selecionado, altere o texto do Modelo e salve. Nenhuma outra configuração da integração é afetada.
• Remover o padrão: limpe o seletor de Provedor e salve — a organização fica sem modelo padrão e o Playground ficará bloqueado até você configurar novamente.

Nota

Quando o provedor escolhido for o Prodgy.AI, o campo de Modelo pode ser deixado vazio: o Prodgy.AI seleciona o modelo adequado internamente e o badge no Playground mostra apenas o nome do provedor.