Identifiants, skills et scripts

Ces trois points d’extension affectent l’exécution agent, avec des buts et frontières de confiance différents.

Identifiants agent

Un identifiant relie Stib à un compte fournisseur/agent. Selon le fournisseur, Stib peut prendre en charge profil OAuth, clé API ou connexion native. L’écran affiche modèles découverts, capacités, quota/verrou, vérification et erreurs de rafraîchissement lorsque ces informations existent.

La portée peut être serveur, héritée d’une organisation ou remplacée par un projet. Limitez un identifiant à la plus petite portée utile. Carte, colonne ou board choisissent ensuite parmi ceux qu’ils sont autorisés à voir.

Les clés API de fournisseur et les clés API Stib ne sont pas interchangeables :

• une clé fournisseur autorise le runtime agent à appeler son modèle ;
• une clé Stib autorise un outil externe à appeler certains endpoints projet de Stib.

Les secrets sont chiffrés avec la clé du serveur. La perdre ou la remplacer affecte tous les secrets fournisseur et intégration stockés.

Vérifier avant usage

Utilisez les actions de vérification et découverte de modèles. Une connexion OAuth réussie ne garantit ni quota, ni accès au modèle, ni toutes les capacités natives. Corrigez un identifiant expiré ou verrouillé avant de relancer les cartes qui en dépendent.

Skills

Les skills sont des instructions/outils découverts depuis des emplacements serveur et projet. Les skills Stib fournis s’activent une fois, dans les paramètres du serveur, et sont installés dans le dossier de skills global de l’utilisateur — tous les projets et tous les worktrees de cartes les voient, et rien n’est écrit dans les dépôts. La section Skills d’un projet montre ce que ses agents reçoivent et porte un seul levier propre : une portée maximale des agents (lecture seule, propre carte, orchestration) que le serveur applique à chaque commande stib, quels que soient les skills activés. Les dossiers natifs des fournisseurs peuvent aussi être découverts lorsqu’ils sont compatibles.

Le skill d’une colonne doit être un skill découvert valide. Il s’exécute dans les limites du mode de la colonne et ne contourne pas les permissions propres au fournisseur agent.

Relisez la source avant activation : un skill peut demander l’exécution de commandes, la lecture de fichiers ou l’appel de systèmes externes.

Scripts projet

Les scripts sont des commandes shell explicites exécutées par le serveur dans le dossier de travail. Configurez nom, commande et options dans Paramètres du projet → Scripts.

Règles recommandées :

• placez les scripts complexes dans le dépôt et appelez-les par une commande Stib courte ;
• rendez les codes de sortie utiles et les diagnostics concis ;
• n’intégrez pas d’identifiant dans la commande ;
• ajoutez délais et idempotence pour l’automatisation ;
• testez avec le même système de fichiers et toolchain serveur/conteneur que les agents.

Les exécutions ont leur propre statut et leurs logs. Annuler arrête le processus mais n’annule pas ses effets déjà produits.

Suite : Pipeline et automatisation et Configuration du serveur.