Tutoriel de démarrage QoderWake

QoderWake vous permet de créer une équipe d'employés numériques (Wakers) sur votre machine locale. Chaque employé a un rôle, un nom, une persona et une expertise. Vous pouvez les appeler pour discuter ou travailler, et ils peuvent également démarrer automatiquement selon des planifications ou des événements.

Concept clé du produit : employés numériques 7x24« Toujours éveillé, toujours au travail. »

QoderWake est une plateforme de gestion d'employés numériques qui prend en charge le déploiement local et cloud.

  • Fonctionnalités clés : sécurisé et contrôlable, prêt pour la production, en évolution continue.

  • Concepts clés : trois niveaux de progression, du Rôle à l'Agent, puis aux Équipes d'Agents/Organisations.

Tout d'abord, cliquez pour visiterle site officiel de QoderWorkCréer un compte QoderWork Essai gratuit de Pro + 300 crédits

Après l'inscription, cliquez sur le boutonTéléchargeren haut à droite:

Sélectionnez l'optionQoderWake, et téléchargez l'installateur en fonction du système de votre ordinateur:

Après le téléchargement, double-cliquez pour installer. L'écran de fin d'installation est le suivant:

Le bouton des paramètres dans le coin inférieur gauche vous permet de définir la langue. Après avoir basculé en chinois, cela ressemble à ceci:

Liste des rôles disponibles

La version bêta sur invitation actuelle couvre les rôles suivants ; choisissez celui qui correspond le mieux à vos besoins:

RôleCaractéristiques des rôles
Ingénieur backendSe concentre sur le développement d'API, la modélisation des données, l'intégration des services, l'optimisation des performances et la stabilité en ligne. Suit les pratiques d'ingénierie de livraison incrémentale, de vérification par les tests et de conception contract-first. Analyse automatiquement les bugs/problèmes et soumet directement des PR après avoir corrigé le code.
Ingénieur frontendSe concentre sur la conception et la mise en œuvre d'interfaces frontend, maîtrise l'architecture des composants, le polissage du langage visuel, l'adaptation responsive, l'optimisation de l'accessibilité et le réglage des performances. Suit la livraison incrémentale, la vérification en couches et la validation fondée sur des preuves, en équilibrant l'expérience utilisateur et la qualité d'ingénierie.
Ingénieur testUn rôle d'assurance qualité pour les outils en ligne de commande généraux et les produits web, axé sur la documentation des plans de test, les tests de bout en bout, la reproduction des défauts et les rapports fondés sur des preuves ; n'exécute pas de tests unitaires et ne corrige pas les problèmes.
Chef de produitUn rôle de gestion de produit natif de l'IA pour les produits logiciels, axé sur la gestion des exigences sur l'ensemble du cycle de vie guidée par les objectifs, la génération de PRD, l'analyse des retours utilisateurs, la recherche concurrentielle et la communication des versions, avec des points d'approbation clairs pour les écritures externes.
Analyste de donnéesUn analyste de données natif de l'IA axé sur la formulation du problème, les définitions de métriques, la collecte de données, le diagnostic des données, le contexte de marché et des recommandations fondées sur des preuves.
Opérations de contenuUn rôle d'opérations de contenu natif de l'IA axé sur le positionnement du compte, les analyses de tendances, les calendriers de contenu, la création de notes Xiaohongshu (RED), les briefs d'actifs visuels, la publication après approbation, l'interaction dans les commentaires, la revue des données, la conformité de la marque et la réécriture multiplateforme.
PersonnaliséDéfinissez les méthodes de travail et les flux de travail de votre propre rôle ; vous pouvez y attacher toute configuration telle que MCP, Skill, etc.

Instructions pour l'environnement d'installation

QoderWake prend en charge le déploiement local et le déploiement cloud.

Il est recommandé de déployer sur un appareil toujours allumé ou un environnement de bureau cloud avec une connexion Internet stable et de bonnes conditions réseau afin de garantir que les employés numériques fonctionnent en continu 24/7.

La version Windows arrive bientôt et n'est pas encore disponible pour le public. Veuillez l'utiliser sur macOS ou Linux pour le moment.

Prérequis pour le déploiement local

Il est recommandé de déployer sur un appareil local pouvant fonctionner de manière stable pendant une longue durée, comme un Mac mini, pour une meilleure expérience d'exécution 24/7.

SystèmeExigences de version
macOS13.0 et supérieur
LinuxUbuntu 22.04 LTS ou version ultérieure recommandé, avec un environnement de bureau graphique activé pour utiliser la console Web locale

Prérequis pour le déploiement cloud

Prend en charge les principaux bureaux cloud et hôtes cloud.

Pour une connexion pratique via navigateur et une gestion Web locale, il est recommandé d'utiliser WuYing Cloud Computer en édition Enterprise ou Personnelle.

Outils prérequis

Le produit est livré avec plusieurs rôles d'employés numériques préconfigurés pour le développement logiciel. Avant l'installation, veuillez préparer un environnement Git et confirmer que le compte actuel peut accéder normalement au dépôt de code cible :

  • Installégit
  • Configuration de l’authentification du dépôt terminée
  • Peut être exécuté normalementclone、pull、pushOpération

Les environnements de déploiement locaux et cloud doivent tous deux prendre en charge l’accès au réseau externe pour la connexion des utilisateurs, l’invocation de modèles, l’accès aux dépôts de code, etc.

Dans les environnements de réseau d’entreprise, de proxy ou de pare-feu, veuillez autoriser à l’avance les accès HTTPS sortants nécessaires.


Étape 1 : Installer QoderWake

Choisissez la méthode d’installation correspondant à votre système d’exploitation.

Installation sur macOS

Méthode 1 : Télécharger directement le paquet d’installation.

Méthode 2 : Installation en un clic via le terminal.

# 一键安装命令,自动检测平台并完成安装
curl -fsSL https://qoder-ide.oss-ap-southeast-1.aliyuncs.com/qoderwake/install.sh | bash

Le script va automatiquement : détecter la plateforme, télécharger et vérifier le paquet d’installation, installer le programme principal et les fichiers de ressources, ajouter l’entrée de commande au PATH, lancer le navigateur pour la connexion, démarrer le service résident local et ouvrir la console Web.

Après l'installation, l'entrée de commande est :

~/.qoderwake/bin/qoderwake

Installation sous Linux

Ouvrez un terminal et exécutez la même commande d'installation en un clic que sous macOS.

Le script d'installation effectuera automatiquement les étapes suivantes :

  1. Détecter l'architecture CPU Linux
  2. Télécharger et vérifier le paquet d'installation QoderWake pour la plateforme correspondante
  3. Installer le programme principal QoderWake et les fichiers de ressources
  4. Créer une entrée de commande et tenter de l'ajouter au PATH
  5. Lancer le navigateur pour la connexion
  6. Après la connexion, démarrer ou redémarrer le service résident local
  7. Ouvrir automatiquement la console Web locale

Entrée de commande :

~/.qoderwake/bin/qoderwake

Adresse par défaut de la console Web :

http://127.0.0.1:19820

Étape 2 : Ouvrir la console

Accéder via le navigateurhttp://127.0.0.1:19820/Ceci est la console de gestion QoderWake sur votre machine locale.

La gestion des employés, l'attribution des tâches et la configuration des permissions sont toutes effectuées ici.

Description de la mise en page de l'interface

ZoneDescription de la fonction
Barre latérale gaucheAffiche la liste "My Wakers", montrant tous les employés créés et leur heure d'activité la plus récente
Boutons du hautCliquez sur "Create Waker" pour créer rapidement un employé ; la partie droite permet de créer de nouvelles tâches
Zone principaleAprès avoir ouvert un employé, la page de chat s'ouvre par défaut, et vous pouvez attribuer des tâches directement.
Barre latérale droiteVoir les détails des tâches créées et des tâches en cours d'exécution

Lors de votre première visite, vous serez guidé pour vous connecter à votre compte — suivez simplement les invites.


Étape 3 : Créer un employé numérique

Cliquez sur le bouton« Create Waker »à gauche pour accéder au flux de création.

Processus de création

  1. Sélectionnez un modèle de rôle :Chaque modèle de rôle est fourni avec une persona intégrée, un flux de travail type, un ensemble de compétences clés et des questions par défaut. Cliquez sur « Voir les détails » pour prévisualiser.
  2. Ou personnalisez un rôle :Si aucun des rôles prédéfinis ne convient, vous pouvez choisir « Rôle personnalisé » et définir entièrement la persona, l'expertise et le style de travail de cet employé, puis configurer ses compétences, connecteurs et autorisations.
  3. Remplissez les informations de base :Remplissez le nom, l'avatar et la biographie de l'employé. Si vous avez sélectionné un rôle prédéfini, le contenu sera rempli automatiquement et pourra être ajusté selon vos besoins.
  4. Enregistrer :Cliquez sur Enregistrer et l'employé est créé. Un employé nouvellement créé entrera dans une configuration guidée lors de sa première création, recommandant les compétences à associer et les canaux à connecter en premier. Vous pouvez ignorer cette étape et le configurer plus tard.

Pour obtenir de meilleurs résultats avec un rôle personnalisé, il est recommandé de fournir des informations complètes sur le rôle lors de la création — positionnement du rôle, responsabilités clés, flux de travail, compétences requises et configurations des capacités des outils telles que MCP.


Étape 4 : Commencer à travailler avec votre employé

Après la création d’un nouvel employé, vous pouvez choisir entreChat directouCréer des tâches automatiséescomme deux façons d’attribuer le travail.

Tâches de conversation

Tapez simplement votre demande dans le champ de saisie et envoyez-la, et l’employé commence à travailler.

Opérations que vous pouvez effectuer pendant le processus :

OpérationDescription
Relancer, ajuster la directionIntervenez à tout moment, et l’employé poursuit avec le contexte
Joindre des fichiers/captures d’écranVous pouvez joindre des fichiers à n’importe quel tour de la conversation
InterrompreSi l’employé s’écarte du sujet, vous pouvez l’arrêter
Opérations d’approbationLorsque l’employé a besoin de manipuler des fichiers, d’exécuter des commandes ou de se connecter en ligne, il fait une pause pour demander votre consentement — vous cliquez sur "Autoriser" ou "Refuser"
Répondre aux questions de l’employéLorsqu’il rencontre un choix, il revient vous demander ; sélectionnez directement sur la carte
Changer de modèle d’IASi, en cours de conversation, vous estimez qu’il n’est pas assez intelligent ou souhaitez économiser de l’argent, utilisez le menu déroulant en haut pour changer de modèle et continuer
Voir le processus de réflexionVoir le raisonnement de l’employé en temps réel avant qu’il prenne des décisions
Voir les sortiesLe panneau de droite affiche les sorties de l’employé en temps réel, telles que les correctifs de code et les fichiers nouvellement générés
Sélectionner le répertoire de travailEn bas de la conversation, vous pouvez sélectionner le répertoire local dans lequel l’employé travaille

Tâches automatisées

Convient aux scénarios tels que « exécuter une fois par jour » ou « répondre automatiquement lorsqu’un dépôt change ».

Allez dansDétails de Waker - Tâches de déclenchement - Créer, où vous pouvez configurer les éléments suivants :

Élément de configurationDescription
Nom et description de la tâcheLes employés savent quoi faire rien qu'en le lisant
Modèle d'IASélectionnez le modèle à utiliser
Répertoire de travailQuel répertoire local, dépôt ou espace de travail de projet utiliser pour l'exécution
Méthode de déclenchement (jusqu'à 5 types)Planifié (ponctuel / récurrent / planification complexe), piloté par événement (écouter les modifications d'un dépôt GitHub), webhook (des systèmes tiers déclenchent directement en appelant une adresse fixe)
Nombre maximum / Échéance (facultatif)Limiter les tâches pour qu'elles ne s'exécutent pas indéfiniment

Après l'enregistrement, l'employé travaille automatiquement selon le planning que vous avez défini.

Vous pouvez mettre en pause/activer, exécuter un test immédiatement et consulter l'historique des exécutions à tout moment.


Étape 5 : Gérer vos employés numériques

Accédez à la page de détails de l'employé pour afficher et ajuster toutes les configurations de l'employé.

SectionDescription de la fonction
AccueilAfficher l'avatar, le statut, le nombre de jours depuis l'intégration, le nombre de tâches de déclenchement, le nombre de tâches de conversation et la carte thermique de travail
ProjetsAssociez le dépôt de code ou le répertoire local où travaille l'employé. Un projet peut contenir plusieurs sources (plusieurs répertoires ou dépôts). La mémoire de projet est distincte de la mémoire personnelle de l'employé.
Tâches de déclenchementAjouter/supprimer/modifier/mettre en pause des tâches automatisées sur l'employé
Tâches de conversationParcourir l'historique des conversations et poursuivre la discussion
MémoireAfficher/modifier les connaissances à long terme de l'employé à votre sujet et sur les projets. Sources : accumulées automatiquement pendant les conversations, modifiées manuellement, organisées et dédupliquées périodiquement par le système. Stockées localement, non téléversées dans le cloud.
CompétencesInstallez depuis le Skills Marketplace officiel de Qoder, importez des compétences personnalisées localement ou activez/désactivez les compétences existantes. Les compétences intégrées ne peuvent pas être désinstallées.
ConnecteursIntégrer des outils/services externes (GitHub, Jira, GitLab, etc.)
PermissionsProtection des outils, protection des fichiers, politiques d'outils intégrées. Les opérations à haut risque feront apparaître une carte d'approbation.

Configuration détaillée de l'employé

Gestion de la mémoire

Chaque employé dispose de sa propre mémoire à long terme, utilisée pour accumuler des connaissances sur vous et les projets.

Il existe trois sources de mémoire :

SourceDescription
Accumulation automatiqueLes informations que l'employé estime dignes d'être retenues pendant les conversations sont automatiquement écrites
Écriture manuelleVous pouvez vous rendre sur la page de mémoire et modifier directement.
Organisation du systèmePériodiquement, le système les organise et les déduplique.

Accéder àDétails de l'employé - MémoireVous pouvez parcourir, rechercher et modifier toutes les entrées de mémoire.

La mémoire est stockée localement et n'est pas téléversée vers le cloud.

Compétences

Les compétences sont des paquets de capacités spécialisées que les employés peuvent invoquer dans les conversations ou lors du déclenchement de tâches.

  • Place de marché des compétences :Installer depuis la place de marché officielle des compétences Qoder
  • Téléverser une compétence :Importer localement par vous-même
  • Compétences intégrées :Intégrées au système, elles ne peuvent pas être désinstallées.

Accéder àDétails de l'employé - CompétencesVous pouvez consulter les compétences installées, rechercher dans la place de marché et téléverser des compétences personnalisées.

Connecteurs

Les connecteurs sont des passerelles permettant aux employés de se connecter à des outils/services externes et prennent en charge l'ajout manuel de connecteurs.

Projets

Les projets sont les espaces de travail des employés.

Accéder àDétails de l'employé - ProjetVous pouvez lier des répertoires locaux ou des dépôts git. Un projet peut contenir plusieurs sources (plusieurs répertoires/dépôts). Les projets ont une mémoire indépendante, distincte de la mémoire personnelle de l'employé.

Gestion des permissions

Les permissions contrôlent ce que les employés peuvent et ne peuvent pas faire.

EntrezDétails de l'employé - PermissionsIl comprend deux catégories principales de protection, ainsi que des politiques d'outils intégrées.

Protection des outils

Valide les paramètres des outils en fonction de règles de sécurité intégrées et demande l'autorisation de l'utilisateur lorsque des règles à haut risque sont déclenchées.

Catégorie de règleContenu de détection
Injection de commandeDétecte les opérations dangereuses telles que rm, mv
Abus de ressourcesDétecte les bombes fork, les redémarrages système, etc.
Exécution de codeDétecte l'exécution à distance telle que curl | bash
Abus réseauDétecte les shells inversés et les accès au loopback local
Accès aux fichiers sensiblesDétecte l'accès aux fichiers système critiques
Élévation de privilègesDétecte les opérations d'élévation de privilèges telles que sudo

Protection des fichiers

Contrôle les permissions de lecture et d'écriture des employés sur les fichiers locaux.

Outils intégrés

Paramètres des outils intégrés disponibles pour WakerAutoriser/Demander/DésactiverPolitique.

Lorsqu'une opération d'un employé déclenche une règle de sécurité, une carte d'approbation s'affichera pour que vous puissiez décider de l'autoriser.


Scénario d'exemple : Correction automatique de bugs

Deux modes de pilotage peuvent permettre la correction automatique de bugs.

Méthode A : Lancer manuellement une conversation

  1. Ouvrez la console et sélectionnez unIngénieur BackendWaker avec le rôle
  2. Saisissez vos exigences dans la boîte de dialogue et joignez les informations d'erreur
  3. L'employé analyse le problème, localise la cause racine et fournit un plan de correction
  4. Après confirmation, faites-leur exécuter la correction et soumettre une PR

Exemple

# Saisissez un contenu similaire à ce qui suit dans la boîte de dialogue, en joignant le journal d'erreurs
# "Aidez-moi à enquêter sur la cause racine de cette erreur et fournissez un plan de correction minimal"

# L'employé effectuera des opérations similaires à ce qui suit :
# 1. Analyser le journal d'erreurs et localiser le code problématique
# 2. Fournir un plan de correction pour votre confirmation
# 3. Exécuter la correction du code
# 4. Soumettre une PR au dépôt de code

Lorsqu'il doit exécuter des commandes ou modifier des fichiers pendant le processus, il demandera d'abord votre consentement.

Méthode B : Configurer le traitement automatisé des tâches

  1. Aller àDétails de l'employé - Tâches déclenchées - Nouveau
  2. Sélectionnez la méthode de déclenchement comme"Event", et écoutez les changements d'Issue dans le dépôt GitHub
  3. Rédigez la description de la tâche :"Lorsqu'une nouvelle Issue de type Bug arrive, analysez automatiquement et fournissez une PR de correction."
  4. Après l'enregistrement, dès qu'une nouvelle Issue de type Bug apparaît dans le dépôt, l'employé commence automatiquement l'analyse et la correction

Chacune des deux méthodes a ses scénarios d'application : la méthode A convient au dépannage temporaire et ponctuel ; la méthode B convient aux opérations automatisées continues, ce qui réduit l'intervention manuelle.


Questions fréquentes

Impossible d'ouvrir la console Web après l'installation ?

Vérifiez si le service local fonctionne normalement, et vérifiezhttp://127.0.0.1:19820s'il est accessible.

S'il y a un conflit de port, vérifiez si d'autres programmes occupent le port 19820.

Employé bloqué lors de l'exécution des tâches ?

Vérifiez si l'employé a besoin de votre confirmation d'approbation, et consultez la fenêtre de dialogue pour les éventuelles cartes d'approbation en attente.

Les rôles personnalisés ne fonctionnent pas bien ?

Il est recommandé de fournir des informations complètes sur le rôle lors de la création : notamment le positionnement du rôle, les responsabilités principales, le flux de travail, les compétences requises et les configurations de capacités des outils telles que MCP. Plus les informations sont complètes, meilleurs sont les résultats.

Comment fournir des commentaires ?

Si vous rencontrez des problèmes ou avez des commentaires sur les fonctionnalités du produit, cliquez sur le bouton de commentaires dans le coin inférieur droit de la console pour les soumettre. L'équipe vous répondra et les résoudra dès que possible.

Autres extensions