DeepSeek Harness: Configuração de Modelo

1. Visite https://platform.deepseek.com/
2. Registre/faça login na sua conta
3. Vá para a página API Keys
4. Clique em "Create API Key"
5. Copie a Key gerada (começa com sk-)

Barra de controle superior → ⚙️ Settings → Models → DeepSeek API Key
┌─────────────────────────────────────────┐
│ DeepSeek API Key                         │
│ sk-•••••••••••••••••••••••••••xxxx       │
│ [Testar Conexão]  [Salvar]               │
└─────────────────────────────────────────┘

✅ Conexão bem-sucedida!
   Model: deepseek-chat
   Latência: 120ms

# Configurar no arquivo .env ou shell
export DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# dsh.config.yaml
models:
  deepseek:
    api_key: "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    base_url: "https://api.deepseek.com/v1"

Settings → Models
┌──────────────────────────────────────────────┐
│ 📡 Model Providers                            │
│                                                │
│ ┌─ DeepSeek ────────────────────────────────┐ │
│ │ API Key: sk-•••••••••xxxx                 │ │
│ │ Base URL: https://api.deepseek.com/v1     │ │
│ │ Default Model: deepseek-chat              │ │
│ │ [Testar] [Salvar]                         │ │
│ └───────────────────────────────────────────┘ │
│                                                │
│ ┌─ OpenAI Compatible ───────────────────────┐ │
│ │ API Key: sk-•••••••••xxxx                 │ │
│ │ Base URL: https://api.openai.com/v1       │ │
│ │ Default Model: gpt-4o                     │ │
│ │ [Testar] [Salvar]                         │ │
│ └───────────────────────────────────────────┘ │
│                                                │
│ [+ Adicionar Provedor]                        │
└──────────────────────────────────────────────┘

# dsh.config.yaml
models:
  deepseek:
    api_key: "${DEEPSEEK_API_KEY}"
    default_model: deepseek-chat
    params:
      temperature: 0.7
      max_tokens: 4096
      top_p: 0.95
  openai:
    api_key: "${OPENAI_API_KEY}"
    default_model: gpt-4o
    params:
      temperature: 0.5
      max_tokens: 8192

# dsh.config.yaml
models:
  openai:
    api_key: "${OPENAI_API_KEY}"
    base_url: "https://api.openai.com/v1"
    default_model: gpt-4o

# dsh.config.yaml
models:
  azure:
    api_key: "${AZURE_OPENAI_API_KEY}"
    base_url: "https://your-resource.openai.azure.com/openai/deployments/your-deployment"
    default_model: gpt-4o
    headers:
      api-key: "${AZURE_OPENAI_API_KEY}"

# dsh.config.yaml
models:
  ollama:
    api_key: "ollama"           # Ollama não precisa de uma Key real
    base_url: "http://localhost:11434/v1"
    default_model: llama3.2

# dsh.config.yaml
models:
  custom:
    api_key: "${CUSTOM_API_KEY}"
    base_url: "https://your-llm-service.com/v1"
    default_model: your-model-name
    headers:
      X-Custom-Header: "custom-value"

[deepseek-chat ▼]
┌──────────────────────────┐
│ ● deepseek-chat          │
│   DeepSeek · 64K ctx     │
│                          │
│ ○ gpt-4o                 │
│   OpenAI · 128K ctx      │
│                          │
│ ○ llama3.2               │
│   Ollama · 8K ctx        │
└──────────────────────────┘

# dsh.config.yaml
routing:
  rules:
    - match:
        mode: ptc            # Modo PTC
      model: deepseek-reasoner   # Usar modelo de raciocínio para planejamento
    
    - match:
        tool: file_edit      # Edição de arquivo
      model: deepseek-coder  # Usar modelo de código
    
    - match:
        mode: creative       # Modo criativo
      model: gpt-4o          # Usar GPT-4o
    
    - match:
        default: true        # Rota padrão
      model: deepseek-chat

# Especificar modelo na inicialização
npx @deepseek-ai/dsh cli --model gpt-4o

# Trocar modelos durante uma sessão (comando interno do CLI)
/model deepseek-reasoner

# Arquivo .env (não commitado no Git)
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxx
OPENAI_API_KEY=sk-yyyyyyyyyyyyyyyy

# Arquivo .env.example (commitado no Git, para referência da equipe)
DEEPSEEK_API_KEY=your-deepseek-api-key
OPENAI_API_KEY=your-openai-api-key

# .gitignore
.env
.env.local
.env.*.local

# dsh.config.yaml — Use ${VAR} para referenciar variáveis de ambiente
models:
  deepseek:
    api_key: "${DEEPSEEK_API_KEY}"    # Lido da variável de ambiente em runtime
    base_url: "https://api.deepseek.com/v1"
  openai:
    api_key: "${OPENAI_API_KEY}"
    base_url: "https://api.openai.com/v1"

# dsh.config.yaml — Integração AWS Secrets Manager (exemplo)
models:
  deepseek:
    api_key:
      vault: aws-secrets-manager
      secret_id: "dsh/deepseek-api-key"
      region: "us-east-1"

1. Imediatamente desabilite/delete a Key vazada na plataforma do provedor de API
2. Gere uma nova Key e atualize a configuração
3. Verifique os logs de chamadas de API para confirmar uso anormal
4. Revise o histórico Git para garantir que a Key não foi commitada (se commitada, use git filter-branch para removê-la)

# Testar DeepSeek API
curl -s https://api.deepseek.com/v1/models \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY"

# Testar endpoint compatível com OpenAI
curl -s https://api.openai.com/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"

# Testar Ollama local
curl -s http://localhost:11434/v1/models

# Configurar proxy HTTP
export HTTP_PROXY="http://proxy.example.com:8080"
export HTTPS_PROXY="http://proxy.example.com:8080"

# Ou especificar no arquivo de configuração
# dsh.config.yaml
models:
  deepseek:
    api_key: "${DEEPSEEK_API_KEY}"
    base_url: "https://api.deepseek.com/v1"
    proxy: "http://proxy.example.com:8080"