Modelos e Provedores

Visao Geral

Neotask suporta uma ampla gama de provedores de modelos de IA. Voce pode usar modelos hospedados na nuvem da Anthropic, OpenAI e Google, executar modelos locais via Ollama ou vLLM, ou conectar-se a qualquer endpoint de API compativel com OpenAI.

Provedores Suportados

Provedores Cloud

Provedor Modelos Auth
Anthropic Claude Opus 4.6, Claude Sonnet 4.1, Claude Haiku 4.5 API key ou setup-token
OpenAI GPT-5.2, GPT-5.1, GPT-4 Turbo, GPT-4 API key
Google (Gemini) Gemini 3 Pro, Gemini 2 Flash, Gemini 1 Pro API key ou OAuth
Together AI Varios modelos open-weight (Llama, Mixtral, etc.) API key
Moonshot (Kimi) Moonshot v1 (contexto 32K, 128K) API key
OpenRouter Mais de 100 modelos de multiplos provedores API key
DeepSeek DeepSeek Chat, DeepSeek Coder API key
OpenCode Zen Variantes do Claude, modelos custom-tuned API key

Provedores de Modelos Locais

Provedor Descricao
Ollama Execute modelos open-weight localmente (Llama, Mistral, etc.)
vLLM Servidor de inferencia local de alto throughput
LiteLLM Proxy unificado para mais de 100 provedores

Provedores Personalizados

Conecte qualquer API compativel com OpenAI ou Anthropic especificando uma URL base e API key. Isso funciona com servidores de inferencia auto-hospedados, endpoints de proxy enterprise e APIs de modelos de terceiros.

Configuracao de Modelos

Modelo Primario

Defina um modelo padrao para todos os agentes. Cada agente pode sobrescrever isso com seu proprio modelo primario.

Cadeias de Fallback

Configure uma lista priorizada de modelos de fallback. Se o modelo primario falhar (limite de taxa, indisponibilidade, erro de autenticacao), Neotask tenta automaticamente o proximo modelo na cadeia.

Modelos de Imagem

Configuracao de modelo separada para analise e geracao de imagens. Suporta Claude Vision, GPT-4 Vision e DALL-E 3.

Aliases de Modelos

Crie atalhos para nomes de modelos longos. Por exemplo, crie um alias fast para anthropic/claude-haiku-4-5 para referencia rapida.

Sobrescrita por Agente

Cada agente pode ter sua propria configuracao de modelo, independente do padrao global.

Listas de Permissao de Modelos

Restrinja quais modelos os agentes podem usar. Util para controle de custos ou conformidade.

Gestao de API Keys

Fontes de Chave (Ordem de Prioridade)

  1. Chave de sobrescrita ao vivo (prioridade mais alta)
  2. Lista de chaves separadas por virgula (rotacao)
  3. Chave primaria
  4. Chaves numeradas (key_1, key_2, etc.)

Rotacao Automatica de Chaves

Quando um limite de taxa e atingido, Neotask rotaciona automaticamente para a proxima chave disponivel. Falhas que nao sao de limite de taxa retornam erros imediatamente sem rotacao.

Configuracao por Provedor

Cada provedor pode ter seu proprio conjunto de API keys, perfis de autenticacao e configuracoes especificas de modelo.

Metodos de Auth de Provedores

Metodo Descricao
API Key Autenticacao padrao por bearer token
Setup Token Fluxo de autenticacao interativo (Anthropic)
OAuth Auth delegada com refresh tokens (Google, GitHub Copilot)
Token Paste Entrada manual de token para provedores especializados

Prioridade de Selecao de Modelo

Quando um agente precisa fazer uma chamada LLM, modelos sao selecionados nesta ordem:

  1. Sobrescrita por agente (se definida)
  2. Modelo padrao global
  3. Lista de permissao de modelos (se configurada, limita opcoes)
  4. Primeiro modelo disponivel (fallback)

Restricoes de Ferramentas por Provedor

Voce pode restringir quais ferramentas estao disponiveis para modelos ou provedores especificos. Por exemplo, limite um modelo menos confiavel a operacoes de arquivo apenas, enquanto da ao Claude acesso completo a ferramentas.