# 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.