Guide des agents Flaq AI

Guide pratique pour utiliser DeepSeek Harness avec l’API compatible OpenAI de Flaq AI

Exécutez l’interface Web open source de DeepSeek Harness avec le point de terminaison compatible OpenAI de Flaq AI, puis connectez un modèle DeepSeek v4 pris en charge pour l’analyse de dépôts et les flux de travail de programmation. DeepSeek Harness repose sur une architecture où « tout est un plugin » : les adaptateurs de modèles, les outils, la boucle d’agent, le stockage des sessions, les autorisations, le sandboxing, la télémétrie et l’interface Web peuvent être assemblés ou remplacés à l’aide de plugins et de la configuration.

Guides d'agents

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

Installer

Exécuter DeepSeek Harness

DeepSeek Harness nécessite Node.js 22.19+ ou une version 24+. Démarrez-le depuis le répertoire du projet que vous souhaitez utiliser comme emplacement par défaut du système de fichiers ; la commande npm officielle lance par défaut l’interface Web à l’adresse http://127.0.0.1:3080.

1

Exécuter l’interface Web de DeepSeek Harness

Utilisez le package npm officiel pour démarrer l’interface Web. Laissez ce terminal ouvert pendant que vous utilisez DeepSeek Harness.

Lors du premier lancement, le package @deepseek-ai/dsh actuel est téléchargé et le profil de l’interface Web est initialisé.

Commande npm officielle

npx @deepseek-ai/dsh web

Dépôt : Consultez les dernières instructions d’installation, versions, notes de compatibilité et le code source dans le dépôt GitHub officiel de DeepSeek Harness.

Configurer

Connecter DeepSeek Harness à Flaq AI

Ouvrez Settings → Models dans DeepSeek Harness, ajoutez Flaq AI en tant que fournisseur personnalisé et saisissez votre clé API Flaq. Le Provider ID devient définitif après l’enregistrement ; utilisez donc flaq, sauf si vous avez volontairement besoin d’un autre nom de route. Après avoir enregistré le fournisseur, choisissez un espace de travail avant de démarrer une session.

Modèle DeepSeek v4 Pro recommandé pour l’analyse de dépôts, les tâches de programmation et les flux de travail qui bénéficient d’un raisonnement plus poussé.

Dans Settings → Models, sélectionnez Add provider → Add a custom provider. Saisissez les valeurs ci-dessous et ajoutez manuellement l’ID du modèle choisi au lieu d’utiliser Fetch available models. Enregistrez le fournisseur, puis sélectionnez ce modèle pour une nouvelle session. DeepSeek Harness traite les modèles saisis manuellement comme des modèles texte uniquement, sauf si des modalités supplémentaires sont déclarées.

  • Utilisez exactement l’URL de base de Flaq et le protocole openai-completions.
  • Remplacez l’espace réservé par votre clé API Flaq et conservez l’ID du modèle exactement comme indiqué.

Fournisseur personnalisé 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

Vérifier

Vérifier Flaq dans DeepSeek Harness

Ouvrez l’interface Web, choisissez le répertoire du projet dans lequel vous avez démarré DeepSeek Harness, sélectionnez le modèle Flaq configuré et créez une nouvelle session. La zone de saisie reste indisponible tant qu’un espace de travail n’a pas été sélectionné.

  • DeepSeek Harness affiche l’URL active dans le terminal.
  • L’adresse locale par défaut est indiquée ci-dessous.

Ouvrir l’interface Web

http://127.0.0.1:3080
  • Envoyez d’abord une tâche en lecture seule.
  • Une réponse normale qui tient compte de l’espace de travail sélectionné confirme que DeepSeek Harness peut atteindre le point de terminaison Flaq et utiliser le modèle configuré.

Tester l’accès au dépôt

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

Exemple de plugin

Installer un plugin DeepSeek Harness

Prenez DSH OpenPencil comme exemple concret de l’architecture de DeepSeek Harness où « tout est un plugin ». Terminez la configuration et la vérification du fournisseur Flaq ci-dessus, arrêtez l’interface Web en cours d’exécution, ajoutez le plugin au profil web et redémarrez la même version de DeepSeek Harness. DSH OpenPencil ajoute des outils permettant de créer, prévisualiser, inspecter et modifier des documents de conception .op au sein d’une conversation.

1

Installer DSH OpenPencil

Ajoutez le package OpenPencil public au profil web avec la version de DeepSeek Harness actuellement testée par le plugin. Exécutez cette commande depuis le même répertoire de projet que celui utilisé pour DeepSeek Harness.

Installer DSH OpenPencil

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

Dépôt : Consultez le code source, les exigences de configuration, les versions et les notes de compatibilité dans le dépôt GitHub de DSH OpenPencil.

2

Redémarrer l’interface Web

Redémarrez la version testée de DeepSeek Harness afin que le profil web charge DSH OpenPencil. Laissez ce terminal ouvert pendant que vous rouvrez l’interface Web.

Redémarrer l’interface Web

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

Tester DSH OpenPencil avec Flaq AI

Sélectionnez le modèle Flaq configuré et l’espace de travail, démarrez une nouvelle session et envoyez la requête ci-dessous. Lorsque le binaire OpenPencil est disponible, le plugin doit créer un document .op et présenter un aperçu modifiable dans la conversation.

Tester DSH OpenPencil avec 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.

Open source

Explorer le dépôt officiel de DeepSeek Harness

DeepSeek Harness est un environnement d’agents open source développé par DeepSeek AI. Consultez le dépôt officiel pour examiner le code source, suivre les versions et les changements de compatibilité, lire la documentation la plus récente et signaler des problèmes pendant la phase d’aperçu destinée aux développeurs.

DeepSeek Harness sur GitHub

Ouvrez le dépôt officiel de DeepSeek Harness pour accéder au code source, à la documentation de configuration, aux notes de développement, aux discussions et aux actualités du projet.

Guide open source

Explorer le guide open source de Flaq AI consacré à DeepSeek Harness

Allez au-delà de la configuration initiale avec le guide indépendant de DeepSeek Harness de Flaq AI, tenu à jour par la communauté. Découvrez comment son arborescence de plugins, ses profils, ses bundles, ses couches de correctifs, sa boucle d’agent remplaçable, ses adaptateurs de modèles, ses outils, ses services de session, ses politiques d’autorisation, ses sandboxes et ses extensions de l’interface Web prennent en charge des flux de travail d’agents personnalisés.

Guide de DeepSeek Harness sur GitHub

Découvrez des notes pratiques sur l’architecture, un manuel d’utilisation, des recettes de développement de plugins, une documentation multilingue et des skills d’agents réutilisables pour comprendre, étendre et développer des solutions à partir de DeepSeek Harness.

Dépannage

FAQ sur DeepSeek Harness

L'utilisation de cette configuration dans ce guide peut augmenter sensiblement l'utilisation des tokens.

Discussions sur DeepSeek Harness sur X (Twitter)

Découvrez les discussions de développeurs et de premiers utilisateurs autour de DeepSeek Harness (DSH), un environnement d’agents open source, portant sur son architecture où « tout est un plugin », son runtime composable, son écosystème de plugins et les expériences pratiques.