ModelOps: catálogo e fallback por modelo
Escolha os modelos habilitados para a empresa e configure uma alternativa para falhas temporárias do provedor.
Escolha os modelos habilitados para a empresa e configure uma alternativa para falhas temporárias do provedor.
Como usar
No ModelOps do Admin, habilite os modelos necessários e associe o fallback a cada modelo. Configure os conectores dos dois provedores e valide ferramentas, imagens e saídas estruturadas exigidas pelo agente. O fallback também precisa estar habilitado no catálogo da empresa.
Limites e pré-requisitos
Há uma única tentativa de fallback em falhas temporárias, como 429 e 5xx. Erros de autorização, validação e ferramentas não provocam troca. Recursos vinculados ao provedor, como VectorStoreId, podem impedir a troca entre provedores. Plataformas externas de voz não passam por esse fallback.
Como validar na sua operação
Teste a alternativa em homologação e confira modelo efetivo, tentativas e custo. A troca não altera o modelo salvo no agente. Sem configuração própria, a empresa não recebe automaticamente todos os modelos globais.
Migração planejada de um agente
A migração administrativa troca o provedor e o modelo de um agente da empresa, preservando prompts, proprietário, grupos e demais configurações. Consultar esse inventário exige ViewTenantConfig; migrar exige UpdateTenantConfig. O inventário administrativo não equivale à lista de agentes visíveis para um usuário comum.
O destino precisa estar habilitado no catálogo da empresa, ser um modelo do tipo Normal e ter um conector do provedor habilitado. Se houver conhecimento vinculado por VectorStoreId, a troca entre provedores é recusada. Planeje a adaptação do conhecimento antes de alterar o provedor; não remova esse vínculo apenas para contornar a validação.
A operação confere o provedor e o modelo de origem. Se o agente mudou desde a seleção, pode retornar false sem migrar: atualize o inventário e revise a configuração atual. Após uma migração confirmada, valide ferramentas, conhecimento, qualidade e custo com casos representativos. A gravação da nova configuração não executa um teste de IA nem garante comportamento equivalente ao modelo anterior.
Checklist de configuração
- Confirme que o modelo está ativo no catálogo global e habilitado no catálogo da sua empresa.
- Cadastre e habilite o conector do fornecedor com as credenciais da empresa.
- Escolha um fallback também habilitado e compatível com os recursos do agente.
- Verifique imagens, ferramentas, saídas estruturadas e recursos de conhecimento vinculados a um fornecedor.
- Teste o fluxo principal e uma falha temporária em homologação. Confira modelo usado, tentativas e custo.
Um catálogo vazio não herda todos os modelos globais: deixa a empresa sem modelos disponíveis. Um fallback vazio desativa a alternativa daquele modelo; não herda automaticamente a configuração global.
Quando a troca acontece
| Situação | Comportamento |
|---|---|
| Erro temporário de provedor: 429, 408, 504, outros 5xx ou transporte. | Uma tentativa na alternativa configurada, se compatível. |
| Erro de autenticação, validação, ferramenta ou cancelamento. | Não aciona fallback. Corrija a causa do erro. |
| Falha também no fallback. | A execução termina; não há encadeamento ilimitado de modelos. |
| Conhecimento com arquivo ou índice exclusivo de fornecedor. | Pode bloquear a troca entre provedores. Migre e valide o recurso antes. |
| Agente executado em plataforma externa de voz. | Não participa do fallback conversacional interno. |
Valide o resultado, não apenas a ausência de erro
A alternativa pode produzir uma resposta diferente. Use os mesmos casos de avaliação do fluxo principal e verifique a continuidade das ferramentas. A troca ocorre durante a execução e não modifica o modelo persistido no agente. O registro identifica o fornecedor efetivo, fallbackUsed e modelAttempts; custos acompanham o modelo realmente utilizado.
ModelOps melhora a resiliência a falhas temporárias, mas não substitui o encaminhamento humano para decisões fora do escopo ou a correção de credenciais e permissões.
Disponibilidade
Novidade identificada no código da plataforma em outubro de 2026. A disponibilidade depende da versão implantada, das permissões e dos conectores do seu ambiente. Consulte a Zild se o recurso ainda não aparecer.
Documentação revisada: 2026-10-28.