# 🔑 Configuração de APIs de IA

## Como Configurar

1. **Acesse Configurações:**
   - No menu lateral, clique em "⚙️ Configurações"
   - Ou acesse diretamente: `/settings`

2. **Adicione uma Nova Configuração:**
   - Selecione o provedor (OpenAI, Anthropic, Google, etc)
   - Cole sua API Key
   - Escolha o modelo
   - Ajuste temperatura e max tokens (opcional)
   - Marque "Definir como configuração ativa"
   - Clique em "Salvar Configuração"

3. **Pronto!**
   - Suas IAs agora usarão a API configurada
   - Você pode ter múltiplas configurações e alternar entre elas

## Provedores Suportados

### OpenAI (GPT-3.5, GPT-4)
- **URL:** Preenchida automaticamente
- **Modelos:** gpt-3.5-turbo, gpt-4, gpt-4-turbo-preview, gpt-4o
- **API Key:** Começa com `sk-`

### Anthropic (Claude)
- **URL:** Preenchida automaticamente
- **Modelos:** claude-3-opus, claude-3-sonnet, claude-3-haiku
- **API Key:** Começa com `sk-ant-`

### Google (Gemini)
- **URL:** Preenchida automaticamente
- **Modelos:** gemini-pro, gemini-pro-vision
- **API Key:** Chave do Google Cloud

### API Customizada
- Permite configurar qualquer API compatível
- Você precisa fornecer a URL e modelo

## Parâmetros

### Temperatura (0-2)
- **0.0-0.3:** Respostas mais determinísticas e focadas
- **0.7:** Equilíbrio (recomendado)
- **1.0-2.0:** Respostas mais criativas e variadas

### Max Tokens
- **500-1000:** Respostas curtas
- **1000-2000:** Respostas médias (recomendado)
- **2000-4000:** Respostas longas

## Segurança

- Suas API Keys são armazenadas de forma criptografada no banco de dados
- Cada usuário tem suas próprias configurações
- Não compartilhe suas API Keys com ninguém

## Migração do Banco de Dados

Se você já instalou o sistema antes, execute o arquivo de migração:

```sql
-- Execute: database/migration_api_config.sql
```

Ou execute manualmente no MySQL:

```sql
CREATE TABLE IF NOT EXISTS api_configurations (
    id INT AUTO_INCREMENT PRIMARY KEY,
    user_id INT NOT NULL,
    provider VARCHAR(50) NOT NULL,
    api_key VARCHAR(500) NOT NULL,
    api_url VARCHAR(500) NULL,
    model VARCHAR(100) DEFAULT 'gpt-3.5-turbo',
    temperature DECIMAL(3,2) DEFAULT 0.7,
    max_tokens INT DEFAULT 1000,
    is_active BOOLEAN DEFAULT TRUE,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
);
```

## Troubleshooting

### "Nenhuma API configurada"
- Acesse Configurações e adicione uma API
- Certifique-se de marcar como "ativa"

### Erro de autenticação
- Verifique se a API Key está correta
- Confirme que a API Key tem créditos/permissões

### Erro de conexão
- Verifique sua conexão com a internet
- Confirme que a URL da API está correta

### Resposta vazia
- Aumente o "Max Tokens"
- Verifique os logs de erro do PHP