Skip to Content
Guide utilisateurFonctionnalitésCanauxPlugins

Plugins de canal personnalisés

Vous pouvez étendre le système de canaux avec des adaptateurs de plateforme personnalisés conditionnés en tant qu’extensions. Cela vous permet de connecter Qwen Code à n’importe quelle plateforme de messagerie, webhook ou transport personnalisé.

Comment ça fonctionne

Les plugins de canal sont chargés au démarrage à partir des extensions actives. Lorsque qwen channel start s’exécute, il :

  1. Analyse toutes les extensions activées pour les entrées channels dans leur qwen-extension.json
  2. Importe dynamiquement le point d’entrée de chaque canal
  3. Enregistre le type de canal pour qu’il puisse être référencé dans settings.json
  4. Crée des instances de canal à l’aide de la fonction d’usine du plugin

Votre canal personnalisé bénéficie gratuitement de l’ensemble du pipeline partagé : filtrage des expéditeurs, politiques de groupe, routage de session, commandes slash, reprise après panne et le pont ACP vers l’agent.

Installation d’un canal personnalisé

Installez une extension qui fournit un plugin de canal :

# Depuis un chemin local (pour le développement ou les plugins privés) qwen extensions install /path/to/my-channel-extension # Ou liez-le pour le développement (les modifications sont reflétées immédiatement) qwen extensions link /path/to/my-channel-extension

Configuration d’un canal personnalisé

Ajoutez une entrée de canal à ~/.qwen/settings.json en utilisant le type personnalisé fourni par l’extension :

{ "channels": { "my-bot": { "type": "my-platform", "apiKey": "$MY_PLATFORM_API_KEY", "senderPolicy": "open", "cwd": "/path/to/project" } } }

Le type doit correspondre à un type de canal enregistré par une extension installée. Consultez la documentation de l’extension pour connaître les champs spécifiques au plugin requis (par exemple, apiKey, webhookUrl).

Toutes les options de canal standard fonctionnent avec les canaux personnalisés :

OptionDescription
senderPolicyallowlist, pairing, ou open
allowedUsersListe d’autorisation statique des ID d’expéditeurs
sessionScopeuser, thread, ou single
cwdRépertoire de travail pour l’agent
instructionsPréfixé au premier message de chaque session
modelRemplacement de modèle pour le canal
groupPolicydisabled, allowlist, ou open
groupsParamètres par groupe

Voir Vue d’ensemble pour les détails de chaque option.

Démarrage du canal

# Démarre tous les canaux, y compris les personnalisés qwen channel start # Démarre uniquement votre canal personnalisé qwen channel start my-bot

Ce que vous obtenez gratuitement

Les canaux personnalisés prennent automatiquement en charge tout ce que les canaux intégrés font :

  • Politiques d’expéditeur — contrôle d’accès allowlist, pairing et open
  • Politiques de groupe — Paramètres par groupe avec filtrage optionnel par @mention
  • Routage de session — Sessions par utilisateur, par fil de discussion ou partagées uniques
  • Appairage DM — Flux complet de code d’appairage pour les utilisateurs inconnus
  • Commandes slash/help, /clear, /status fonctionnent immédiatement
  • Instructions personnalisées — Préfixé au premier message de chaque session
  • Reprise après panne — Redémarrage automatique avec conservation de la session
  • Sérialisation par session — Les messages sont mis en file d’attente pour éviter les conditions de concurrence

Construction de votre propre plugin de canal

Vous souhaitez créer un plugin de canal pour une nouvelle plateforme ? Consultez le Guide du développeur de plugins de canal pour l’interface ChannelPlugin, le format Envelope et les points d’extension.

Last updated on