Modelos de IA
Um modelo de IA no MonoChat é uma conexão salva com um modelo de um provedor: o provedor, o nome do modelo, as credenciais e as configurações padrão com que o modelo é executado. Todo recurso de IA escolhe seu modelo nesta lista: o nó Criar conclusão de chat com IA, o nó Agente de IA, os Escopos de IA (para embeddings e transcrição de voz) e a transcrição de mensagens de voz.
Você os gerencia em Configurações › Automação › Modelos de IA.
Modelos fornecidos pelo MonoChat e seus próprios modelos
A lista mostra dois tipos de modelos:
| Tipo | Quem cria | Você pode editar ou excluir? | Quem cobra o uso |
|---|---|---|---|
| Modelos fornecidos pelo MonoChat | MonoChat | Não, são somente leitura para o seu workspace | MonoChat, a partir do saldo do seu workspace |
| Seus próprios modelos | Você, com sua própria chave de API ou endpoint | Sim | Seu provedor, diretamente na sua conta no provedor |
Os modelos fornecidos pelo MonoChat são oferecidos a todos os workspaces, para que você possa começar a usar IA sem uma conta em nenhum provedor de IA. Os preços deles são definidos e gerenciados pelo MonoChat.
Quando um fluxo usa um modelo fornecido pelo MonoChat, o uso (tokens de entrada e de saída, tokens em cache, segundos de transcrição, embeddings, imagens, áudio ou vídeo gerados, uso de ferramentas) é cobrado do seu saldo e aparece em Transações com categorias como Token de entrada de IA, Token de saída de IA ou Transcrição de IA. Um modelo que você cria com suas próprias credenciais não tem preço no MonoChat: seu provedor cobra por ele.
Provedores compatíveis
| Provedor | O que o formulário solicita |
|---|---|
| OpenAI | Chave de API |
| Anthropic | Chave de API |
| Gemini | Chave de API |
| OpenRouter | Chave de API |
| XAI | Chave de API |
| DeepSeek | Chave de API |
| Groq | Chave de API |
| Cohere | Chave de API, Endpoint (opcional, https://api.cohere.ai) |
| Azure | Domínio principal (openai.azure.com), Chave de API, Versão da API (por exemplo 2024-02-15-preview), Nome da instância |
| Ollama | Endpoint (por exemplo http://localhost:11434); o servidor precisa estar acessível a partir do MonoChat |
| AWS | O provedor está listado, mas o formulário atualmente não solicita credenciais para ele |
Com o OpenRouter, uma única chave de API acessa os modelos de vários fornecedores. Informe o ID do modelo do OpenRouter em Nome do modelo (por exemplo openai/gpt-4o-mini).
Adicionar um modelo
- Acesse Configurações › Automação › Modelos de IA e clique em + (Criar).
- Informe um Nome e, se quiser, uma Descrição. O nome é o que você escolherá em nós e escopos.
- Escolha o Provedor.
- Em Configurações gerais de IA, selecione os Recursos que este modelo oferece (veja abaixo) e, para modelos de texto, os Formatos de resposta que ele pode retornar.
- Em Configuração do cliente de modelo de IA, informe o Nome do modelo exatamente como o provedor o chama e depois as credenciais do provedor.
- Ajuste as configurações de geração, se necessário, e clique em Salvar.
O modelo passa a aparecer em todos os seletores de modelo cujo recurso ele possui.
Ao editar um modelo, informe a Chave de API novamente. O MonoChat nunca envia uma chave salva de volta ao seu navegador, por isso o campo fica vazio no formulário de edição.
Campos
Configurações gerais de IA
| Campo | Descrição |
|---|---|
| Recursos | O que o modelo pode fazer: Texto, Embedding, Transcrição, Ferramentas (chamada de ferramentas), Visão (leitura de imagens), Gerar imagem, Gerar vídeo, Gerar áudio e Raciocínio (veja abaixo). Os seletores que exigem um recurso oferecem apenas modelos que o possuem: os escopos de IA pedem Embedding, os seletores de Modelos de IA de fala para texto pedem Transcrição, o nó Agente de IA pede Texto. O MonoChat também recusa uma chamada para a qual o modelo não está marcado, por exemplo ferramentas de IA em um modelo sem Ferramentas. |
| Formatos de resposta | Exibido para modelos de texto. As saídas estruturadas que o modelo aceita: text, json-schema (um JSON Schema que você define no nó de IA) e message-schema (um payload de mensagem do MonoChat, como botões ou listas). |
Configuração do cliente de modelo de IA
| Campo | Exibido para | Descrição |
|---|---|---|
| Nome do modelo | Todos | O identificador do modelo no provedor, por exemplo gpt-4o-mini. |
| Credenciais | Depende do provedor | Veja Provedores compatíveis. |
| Máx. de tokens | Modelos sem Raciocínio | Limite máximo de tokens em uma resposta. |
| Máx. de tokens de conclusão | Modelos de raciocínio | Limite máximo de tokens que o modelo pode gerar, incluindo o raciocínio. |
| Esforço de raciocínio | Modelos de raciocínio | none, minimal, low, medium, high ou xhigh. Um esforço maior dá respostas melhores a perguntas difíceis, ao custo de tempo e tokens. Deixe vazio para usar o padrão do provedor. |
| Verbosidade | Modelos de raciocínio | low, medium ou high: o tamanho que as respostas devem ter. |
| Cache | Todos | Ativado por padrão. Permite que o provedor reutilize partes do prompt em cache, o que reduz custo e latência em prompts repetidos. |
| Máx. de tentativas | Todos | Quantas vezes uma chamada com falha é repetida (1–10). |
| Temperatura | Modelos sem Raciocínio | 0–1. Menor é mais previsível, maior é mais criativo. |
| Top P | Modelos sem Raciocínio | 0–1. Limita a amostragem aos tokens mais prováveis. |
O nó Criar conclusão de chat com IA tem seus próprios campos Máx. de tokens, Máx. de tokens de conclusão, Esforço de raciocínio, Verbosidade, Cache, Máx. de tentativas, Temperatura e Top P. Os valores definidos em um nó substituem os padrões do modelo apenas para esse nó.
Onde os modelos são usados
| Local | Quais modelos oferece |
|---|---|
| Nó Criar conclusão de chat com IA | Modelos para a resposta e um seletor de Modelos de IA de fala para texto para mensagens de voz |
| Nó Agente de IA | Modelos principal, alternativo e rápido, e um modelo de fala para texto. Veja Agentes de IA. |
| Escopos de IA | Um modelo com Embedding para transformar documentos em vetores e um modelo de fala para texto para arquivos de áudio |
Permissões
O acesso é controlado pelas permissões de perfil Ler / Criar / Atualizar / Excluir clientes de modelo de IA na automação. Veja Perfis de acesso.