Guia de agentes da Flaq AI

Guia prático para usar o DeepSeek Harness com a API compatível com OpenAI da Flaq AI

Execute a interface Web de código aberto do DeepSeek Harness com o endpoint compatível com OpenAI da Flaq AI e conecte um modelo DeepSeek v4 compatível para análise de repositórios e fluxos de trabalho de programação. O DeepSeek Harness segue uma arquitetura em que “tudo é um plugin”: adaptadores de modelos, ferramentas, o loop do agente, armazenamento de sessões, permissões, sandboxing, telemetria e a interface Web podem ser combinados ou substituídos por meio de plugins e configurações.

Guias de agentes

Claude Code/cc-apiOpenAI Codex/codex-api/v1Hermes Agent/api/v1DeepSeek Harness/api/v1ZCode/api/v1

Instalar

Executar o DeepSeek Harness

O DeepSeek Harness requer Node.js 22.19+ ou uma versão 24+. Inicie-o no diretório do projeto que deseja usar como local padrão do sistema de arquivos; por padrão, o comando npm oficial inicia a interface Web em http://127.0.0.1:3080.

1

Executar a interface Web do DeepSeek Harness

Use o pacote npm oficial para iniciar a interface Web. Mantenha este terminal em execução enquanto usa o DeepSeek Harness.

A primeira execução baixa o pacote @deepseek-ai/dsh atual e inicializa o perfil da interface Web.

Comando npm oficial

npx @deepseek-ai/dsh web

Repositório: Consulte as instruções de instalação, versões, notas de compatibilidade e código-fonte mais recentes no repositório oficial do DeepSeek Harness no GitHub.

Configurar

Conectar o DeepSeek Harness à Flaq AI

Abra Settings → Models no DeepSeek Harness, adicione a Flaq AI como provedor personalizado e insira sua chave de API da Flaq. O Provider ID se torna permanente depois de salvo, portanto use flaq, a menos que precise intencionalmente de um nome de rota diferente. Depois de salvar o provedor, escolha um espaço de trabalho antes de iniciar uma sessão.

Modelo DeepSeek v4 Pro recomendado para análise de repositórios, tarefas de programação e fluxos de trabalho que se beneficiam de um raciocínio mais avançado.

Em Settings → Models, selecione Add provider → Add a custom provider. Insira os valores abaixo e adicione manualmente o ID do modelo selecionado em vez de usar Fetch available models. Salve o provedor e selecione esse modelo para uma nova sessão. O DeepSeek Harness trata modelos inseridos manualmente como modelos somente de texto, a menos que outras modalidades sejam declaradas.

  • Use exatamente a URL base da Flaq e o protocolo openai-completions.
  • Substitua o espaço reservado por sua chave de API da Flaq e mantenha o ID do modelo exatamente como mostrado.

Provedor personalizado da Flaq AI

Provider ID: flaqDisplay name: Flaq AIBase URL: https://api.flaq.ai/api/v1API protocol: openai-completionsCredential / API key: Your_Flaq_Api_KeyModel ID: deepseek-v4-pro-text-to-text

Verificar

Verificar a Flaq no DeepSeek Harness

Abra a interface Web, escolha o diretório do projeto em que iniciou o DeepSeek Harness, selecione o modelo Flaq configurado e crie uma nova sessão. O editor permanece indisponível até que um espaço de trabalho seja selecionado.

  • O DeepSeek Harness exibe a URL ativa no terminal.
  • O endereço local padrão é mostrado abaixo.

Abrir a interface Web

http://127.0.0.1:3080
  • Envie primeiro uma tarefa somente de leitura.
  • Uma resposta normal que reflita o espaço de trabalho selecionado confirma que o DeepSeek Harness consegue acessar o endpoint da Flaq e usar o modelo configurado.

Testar o acesso ao repositório

Summarize this repository and identify its main packages. Do not modify any files.

Exemplo de plugin

Instalar um plugin do DeepSeek Harness

Use o DSH OpenPencil como exemplo concreto da arquitetura em que “tudo é um plugin” do DeepSeek Harness. Conclua a configuração e a verificação do provedor Flaq acima, interrompa a interface Web em execução, adicione o plugin ao perfil web e reinicie a mesma versão do DeepSeek Harness. O DSH OpenPencil adiciona ferramentas para criar, pré-visualizar, inspecionar e editar documentos de design .op dentro de uma conversa.

1

Instalar o DSH OpenPencil

Adicione o pacote público do OpenPencil ao perfil web com a versão do DeepSeek Harness atualmente testada pelo plugin. Execute este comando no mesmo diretório de projeto usado para o DeepSeek Harness.

Instalar o DSH OpenPencil

npx --yes -p @deepseek-ai/[email protected] dsh plugin --profile web add @zseven-w/dsh-openpencil@latest

Repositório: Consulte o código-fonte, os requisitos de configuração, as versões e as notas de compatibilidade no repositório do DSH OpenPencil no GitHub.

2

Reiniciar a interface Web

Inicie novamente a versão testada do DeepSeek Harness para que o perfil web carregue o DSH OpenPencil. Mantenha este terminal em execução enquanto reabre a interface Web.

Reiniciar a interface Web

npx --yes -p @deepseek-ai/[email protected] dsh web
3

Testar o DSH OpenPencil com a Flaq AI

Selecione o modelo Flaq configurado e o espaço de trabalho, inicie uma nova sessão e envie a solicitação abaixo. Quando o binário do OpenPencil estiver disponível, o plugin deverá criar um documento .op e apresentar uma prévia editável na conversa.

Testar o DSH OpenPencil com a Flaq AI

Create a simple editable OpenPencil document with a title, a subtitle, and two feature cards. Save it as openpencil-demo.op, then render an editable preview.

Código aberto

Explorar o repositório oficial do DeepSeek Harness

O DeepSeek Harness é uma estrutura de agentes de código aberto desenvolvida pela DeepSeek AI. Visite o repositório oficial para consultar o código-fonte, acompanhar versões e alterações de compatibilidade, ler a documentação mais recente e relatar problemas durante a prévia para desenvolvedores.

DeepSeek Harness no GitHub

Abra o repositório oficial do DeepSeek Harness para acessar o código-fonte, a documentação de configuração, notas de desenvolvimento, discussões e atualizações do projeto.

Guia de código aberto

Explorar o guia de código aberto da Flaq AI sobre o DeepSeek Harness

Vá além da configuração inicial com o guia independente do DeepSeek Harness mantido pela comunidade da Flaq AI. Saiba como sua árvore de plugins, perfis, pacotes, camadas de patches, loop de agente substituível, adaptadores de modelos, ferramentas, serviços de sessão, políticas de permissão, sandboxes e extensões da interface Web dão suporte a fluxos de trabalho personalizados de agentes.

Guia do DeepSeek Harness no GitHub

Explore notas práticas sobre a arquitetura, um manual de uso, receitas de desenvolvimento de plugins, documentação multilíngue e skills reutilizáveis de agentes para compreender, ampliar e desenvolver soluções com o DeepSeek Harness.

Solução de problemas

Perguntas frequentes sobre o DeepSeek Harness

Usar esta configuração do guia pode aumentar significativamente o uso de tokens.

Discussões sobre o DeepSeek Harness no X (Twitter)

Explore discussões de desenvolvedores e participantes iniciais sobre o DeepSeek Harness (DSH), uma estrutura de agentes de código aberto, que abordam sua arquitetura em que “tudo é um plugin”, o runtime combinável, o ecossistema de plugins e experiências práticas.