Recherchez toutes les commandes et tous les skills de Hermes dans Telegram : le sélecteur inline @botname contourne la limite des 60 emplacements du menu


Vous avez déjà vécu ce moment : Hermes est votre assistant principal dans Telegram, vous installez skill après skill, et puis un jour vous cherchez un skill précis dans un chat de groupe — vous tapez /, vous faites défiler, et il n’y est pas. Il n’a pas disparu ; le menu a simplement manqué de place. Telegram plafonne durement le menu BotCommand (100 commandes par scope, ~4 Ko de charge utile ; Hermes en expose 60 par défaut), si bien qu’une fois votre collection de skills devenue conséquente, la plupart de leurs commandes ne peuvent jamais apparaître dans le menu /. Une fonctionnalité fusionnée le 30 août contourne entièrement cette limite : tapez @yourbotname + un mot-clé dans n’importe quel chat et un sélecteur vivant et recherchable s’ouvre sur toutes les commandes et skills installés — calculé à chaque frappe, paginé 50 par 50, un appui envoie la commande dans le chat. Le changement vient du PR #98317 et vit actuellement sur main, pas encore dans une release.

Pourquoi le menu / « se remplit »

Le menu de commandes de Telegram a une limite dure au niveau de la plateforme : 100 commandes par scope, ~4 Ko de charge utile totale. La stratégie par défaut de Hermes n’enregistre que 60 emplacements avec les commandes les plus utilisées. Le piège : les skills sont aussi invoqués comme commandes slash, donc chaque skill installé ajoute une entrée de plus — installez quelques dizaines de skills et la plupart de leurs commandes ne tiendront jamais dans le menu /. Ce n’est pas que Hermes soit radin ; la boîte Telegram est simplement aussi petite.

Comment fonctionne le sélecteur inline

Aucune configuration nécessaire au-delà de la mise en place unique décrite ci-dessous. Dans n’importe quel chat Telegram, tapez simplement :

@yourbotname keyword

Si votre bot s’appelle myagent et que vous cherchez des commandes de planification :

@myagent plan

Le bot répond avec un sélecteur vivant et recherchable listant chaque commande et skill correspondant — calculé à chaque frappe, paginé 50 par 50, avec un catalogue complet qui ne retranche jamais rien. Lors des tests officiels, une session avec 72 skills installés a fait remonter 138 entrées (contre 60 emplacements dans le menu /), y compris le skill le moins utilisé, tout en bas de la liste.

Touchez un résultat et le texte de la commande (par ex. /plan migrate auth) est envoyé dans le chat en votre nom. Comme les messages à préfixe de commande atteignent le bot même en mode de confidentialité par défaut, la distribution passe par le chemin de commande existant — aucun nouveau code de distribution n’a été nécessaire.

Mise en place unique : /setinline dans BotFather

Le mode inline est désactivé par défaut pour tous les bots Telegram. Activez-le une fois :

  1. Ouvrez @BotFather ;
  2. Envoyez /setinline et choisissez votre bot ;
  3. Définissez un texte d’espace réservé (par ex. Search commands and skills...).

Tant que ce n’est pas fait, Telegram ne délivre jamais les requêtes inline et le sélecteur reste inerte — c’est pourquoi le gestionnaire est enregistré inconditionnellement : inoffensif quand c’est éteint, instantané quand c’est allumé.

Frontière de sécurité : les inconnus obtiennent une liste vide

Les requêtes inline peuvent arriver de n’importe quel chat, y compris des chats où votre bot n’est pas présent, donc l’authentification est une porte verrouillée : seuls les utilisateurs qui passent la validation allowlist / appairage / routage multiplex de votre gateway voient des résultats — les utilisateurs non autorisés obtiennent une liste vide, si bien que le catalogue de vos skills installés ne fuit jamais vers des inconnus. Les résultats sont aussi marqués is_personal=True, donc Telegram ne partage pas de pages en cache entre utilisateurs.

Le troisième volet du chantier sur la limite du menu

C’est le dernier de trois mouvements contre le problème du « menu trop petit » : PR #98272 a fait de /plan une commande intégrée qui survit à la limite de menu de Discord, PR #98280 a donné aux commandes de skills épinglés la priorité sur les emplacements, et ce sélecteur inline contourne carrément le menu au lieu de s’y serrer. Pour en savoir plus sur l’utilisation de Hermes sur les plateformes de chat, voir notre guide de chat de groupe en Bot Mode.

Quand vous pouvez l’utiliser

Le PR #98317 a été fusionné le 30 août et n’est pas dans v0.20.6 (taggé le 27 août). Pour l’essayer aujourd’hui, tirez le dernier main ; sinon, il arrivera dans la prochaine release. Voir le guide d’installation pour les chemins de mise à jour. Si vous routez plusieurs profiles sur des plateformes de messagerie, le guide de routage multi-profile apporte le contexte utile.

En résumé : la boîte du menu Telegram ne peut contenir qu’un certain nombre d’éléments, mais votre bibliothèque de skills n’a pas à rétrécir pour tenir dedans. Le sélecteur de recherche vivante @botname + mot-clé rend chaque commande et chaque skill découvrables — installez 100 skills sans en perdre un seul.