DeepSeek Harness

Use este guia para rodar o DeepSeek Harness de código aberto com modelos servidos pelo Felo API Platform. O caminho recomendado reutiliza o adaptador deepseek-official integrado ao harness. Você também pode adicionar a Felo como um provedor personalizado separado compatível com OpenAI na Web UI.

O DeepSeek Harness está atualmente em developer preview e pode introduzir mudanças que quebram compatibilidade. Consulte as notas de versão do projeto upstream quando uma opção ou tela divergir deste guia.

Antes de começar

Você precisa do Node.js e de uma chave do Felo API Platform. Mantenha a chave fora do controle de código-fonte.

export FELO_API_KEY="YOUR_API_KEY"

Os exemplos usam deepseek-v4-flash. Consulte Modelos e preços antes de selecionar outro ID de modelo.

Configuração recomendada: adaptador DeepSeek integrado

O DeepSeek Harness lê a credencial do adaptador integrado em DEEPSEEK_API_KEY e o endpoint em DEEPSEEK_BASE_URL.

export DEEPSEEK_API_KEY="$FELO_API_KEY"
export DEEPSEEK_BASE_URL="https://openapi.felo.ai/api/v1"
npx @deepseek-ai/dsh web

Abra http://127.0.0.1:3080 e então:

1. Adicione ou selecione o workspace do seu projeto.
2. Abra Settings → Models.
3. Selecione o provedor deepseek-official e o modelo deepseek-v4-flash.
4. Inicie uma nova sessão e envie uma tarefa pequena sobre o repositório.

Não acrescente /chat/completions à URL base. O adaptador integrado envia as requisições para {DEEPSEEK_BASE_URL}/chat/completions por conta própria.

Persista os valores de ambiente

O DeepSeek Harness consegue ler um arquivo .env no diretório em que você o inicia. Adicione os valores a seguir a um arquivo .env não rastreado se não quiser exportá-los em cada sessão:

DEEPSEEK_API_KEY=YOUR_API_KEY
DEEPSEEK_BASE_URL=https://openapi.felo.ai/api/v1

Não faça commit desse arquivo. Você também pode usar os arquivos de credencial e de configurações do harness em $DSH_HOME quando precisar de configuração no nível do usuário.

Configuração alternativa: provedor personalizado compatível com OpenAI

Use este caminho quando quiser que a Felo apareça como um provedor separado, em vez de substituir a conexão DeepSeek integrada.

1. Inicie a Web UI com npx @deepseek-ai/dsh web.
2. Abra Settings → Models.
3. Escolha Add custom provider.
4. Informe os valores a seguir e salve o provedor.

Se a descoberta de modelos falhar, adicione o ID do modelo manualmente. A ação Get available models de um provedor depende de uma rota GET /models compatível com OpenAI e não é necessária para a configuração manual.

Verifique a configuração

Inicie uma nova sessão e pergunte:

Summarize this repository and identify its main packages.

A configuração está pronta quando a sessão termina com deepseek-v4-flash selecionado e sem erro de autenticação ou de modelo desconhecido.

Para um teste rápido não interativo com o adaptador recomendado, execute a partir do workspace de destino:

npx @deepseek-ai/dsh --profile headless "List the top-level files in this workspace."

Observação sobre busca na web

Esta configuração encaminha as requisições de modelo pela Felo. O provedor web_search integrado ao DeepSeek Harness tem requisitos de endpoint separados, embora sua variável de credencial padrão também seja DEEPSEEK_API_KEY. Não aponte DEEPSEEK_SEARCH_BASE_URL para a Felo, a menos que você esteja usando um endpoint de busca explicitamente compatível. Use a Chat API da Felo ou outros Felo Skills separadamente quando seu fluxo precisar da busca da Felo.

Solução de problemas

Próximos passos

• Repositório do DeepSeek Harness
• Referência da LLM API
• Referência da Chat API
• Felo Skills para agentes de IA