Provedores e modelos

Um Provedor é a conta de um serviço de modelos de IA: AUMO, OpenAI, Bedrock e equivalentes. Um Modelo é uma opção concreta dentro de um provedor, escolhível no formulário de um Agente.

Os dois vivem em níveis diferentes de propósito: o Provedor é da Organização, o Modelo é habilitado por Workspace.

Provedores

Provedores ficam em Organização › Provedores e são o ponto onde as credenciais de IA da empresa são guardadas. Cadastrar um provedor é o que dá à plataforma o direito de chamar aquele serviço.

Só o papel Superadmin abre essa tela. Isso é deliberado: é onde o segredo mora.

O provedor AUMO é o caso especial. Em vez de você trazer a sua conta, a AUMO fornece o acesso, com aprovação e cotas negociadas entre a sua organização e a plataforma.

Modelos

Modelos ficam em Workspace › Configurações › Modelos. É ali que se decide quais opções, entre tudo o que os provedores da organização oferecem, aparecem para quem cria Agentes naquele workspace.

Cada modelo carrega os dados que determinam seu comportamento e seu custo:

• Janela de contexto: quanto texto cabe em uma chamada, somando prompt, histórico e trechos recuperados.
• Máximo de tokens de saída: o teto de uma resposta.
• Preço de entrada e de saída: o custo por token, usado para calcular consumo e cotas.

Um workspace sem nenhum modelo habilitado não deixa criar Agente: o campo Modelo é obrigatório e ficaria vazio.

O caminho até uma resposta

A cadeia completa tem quatro elos, e vale saber onde cada um quebra:

1. A Organização cadastra o Provedor, com a credencial.
2. O Workspace habilita os Modelos daquele provedor que quer oferecer.
3. O Agente escolhe um desses modelos.
4. Cada mensagem no Chat consome tokens daquele modelo, contabilizados no workspace.

Se um modelo some da lista de um Agente que já existia, quase sempre o elo rompido é o 2: alguém o desabilitou no workspace.

Escolhendo um modelo

Três critérios costumam bastar:

• Tamanho do contexto: Agentes com muitas Coleções ou conversas longas precisam de janelas maiores.
• Custo: modelos maiores cobram mais por token, e o Painel mostra o efeito disso no fim do mês.
• Comportamento: prompts iguais rendem respostas diferentes entre modelos. Vale testar o mesmo Agente em dois antes de publicar.

Começar pelo modelo mais barato que resolve a tarefa é o caminho mais previsível. Trocar depois é editar um campo.

Próximos passos

• Veja como o consumo desses modelos é limitado em Quotas e consumo.
• Entenda onde o modelo entra na montagem da resposta em Agentes e SuperAgentes.