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 paramètres projet activent les skills fournis et les matérialisent dans le dépôt si nécessaire. Les dossiers natifs des fournisseurs peuvent aussi être découverts lorsqu’ils sont compatibles.

Une colonne Skill doit référencer un skill découvert valide. Sa disponibilité 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.