HeadOfficeOS Documentação
Construir IAgentes
HEADOFFICE OS / DOCUMENTAÇÃO

Modelos, fallback e créditos

Escolha o modelo pela tarefa e acompanhe qualidade, latência e custo.

Edição de 7 de outubro de 2026 • Português

Modelo principal e fallback

O bloco Modelo do IAgente tem seleção principal, modelo de fallback, comparação e Testar modelo. Os gatilhos exibidos para fallback são Limite de taxa (429), Erro do provedor e Latência alta.

ATLAS DEMO · PASSO A PASSO Use Comparar modelos para abrir o catálogo antes de decidir uma troca.
Use Comparar modelos para abrir o catálogo antes de decidir uma troca.

Fallback é continuidade diante de uma condição configurada. Não é uma garantia de correção nem uma substituição da avaliação de qualidade. Dois modelos podem cometer o mesmo erro quando a fonte ou a instrução está errada.

Método de escolha

PassoO que comparar
Definir tarefaTriagem, redação, extração, análise, uso de ferramentas
Montar amostraMesmas entradas e mesmos resultados esperados
Medir qualidadeCorreção, fonte, respeito aos limites e conclusão
Medir operaçãoLatência, erros de ferramenta e necessidade de intervenção
Medir custoCréditos da jornada completa, incluindo tentativas e gerações

Comece com a opção mais econômica que passe na amostra. Reserve modelos mais caros para tarefas em que a diferença de qualidade seja mensurável.

Como interpretar o saldo

O cabeçalho mostra plano e créditos. A tela do modelo pode informar custo por turno. Outros recursos apresentam unidades próprias; a configuração de câmeras observada, por exemplo, informa custo por frame conforme o modelo.

Não multiplique um único preço por todas as ações. Voz, geração de arquivos, análises e serviços externos podem ter regras próprias. Confirme o valor exibido na interface antes de estimar o orçamento.

Planilha de controle sugerida: data, agente, caso de uso, modelo, número de execuções, créditos, conclusões corretas e intervenção humana. A métrica útil é custo por entrega válida, não apenas custo por mensagem.

Teste de degradação

Documente o que deve acontecer quando o serviço não responde: mensagem clara, nenhum falso sucesso, registro do bloqueio e caminho de retomada. Os gatilhos foram observados na interface; indisponibilidade e fallback real não foram provocados nesta documentação.

Nesta página