Faire suivre au agent le CLI officiel avec Aspire Skills

À qui ça s'adresse

Convient à qui construit des applis Aspire distribuées et veut que l'agent reconnaisse d'abord l'espace de travail, puis utilise correctement le Aspire CLI. Le dépôt officiel est

https://github.com/microsoft/aspire-skills

Il écrit Aspire Skills comme plugin, skill pack et extension pack pour ce travail. L'agent doit router le travail courant vers des skills dédiés, au lieu d'improviser dotnet, curl, Docker ou shell. Le matériau n'impose aucun produit d'agent ; n'ajoutez pas une liste de clients.

Il convient plutôt à la reconnaissance, à la lecture d'orchestration et au diagnostic, pas à une publication d'emblée. Dans le matériau, aspire-deployment Publishes, deploys, and tears down Aspire apps. Ne prenez pas ce chemin au premier essai.

Premier essai en 3 minutes

Le chemin principal utilise le Aspire CLI officiel ; à l'invite, choisissez d'attacher agent guidance. Pour un espace existant, utilisez :

aspire agent init

Le matériau écrit aussi aspire new (créer une appli et choisir le guidage à l'invite) et aspire init (ajouter un squelette Aspire à un dépôt existant et choisir le guidage à l'invite). Le premier essai préfère aspire agent init, car c'est Add, update, or reconfigure Aspire guidance in an existing workspace. Prérequis : cette machine peut déjà exécuter le Aspire CLI, et le répertoire courant est un espace Aspire que vous autorisez à réécrire. Le matériau n'écrit ni le nom de paquet d'install du CLI ni un numéro de version.

Effet de bord : il écrit ou met à jour la config de guidage dans l'espace. Confirmez le répertoire avant d'exécuter. Ensuite, voyez d'abord si l'agent peut recognize Aspire workspaces, puis décidez de démarrer des ressources. Ne déployez ni ne démontez à cette étape.

Tâche à bas risque : laisser le skill de routage de premier niveau aspire faire seulement une vérif en lecture seule, par exemple si l'espace est reconnu et si le CLI est appelé correctement. S'il faut toucher une appli en cours, n'utiliser que aspire-monitoring pour logs, traces, dashboard, telemetry ou diagnostics ; ne pas appeler aspire-deployment. Signal de succès : l'agent ne bascule plus vers un dotnet / curl / Docker / shell improvisé pour ces tâches Aspire. Si le CLI manque, s'arrêter à « cette machine n'a pas de Aspire CLI » ; ne pas finir le premier essai avec un autre installeur.

Cas d'usage

Cas 1 : attacher ou mettre à jour le guidage sur un espace existant. Correspond à aspire agent init et recognize Aspire workspaces. Convient quand le dépôt existe déjà et que vous voulez seulement que l'agent travaille à la manière Aspire. Le matériau n'écrit ni le texte d'invite ni quels fichiers ont été générés ; le fait vérifiable est qu'un espace existant peut mettre à jour guidance. N'écrivez pas le cas 1 comme déjà déployé dans le cloud.

Cas 2 : après l'orchestration, supervision et diagnostic. Correspond à aspire-orchestration (Starts, stops, waits for, and manages Aspire resources) et aspire-monitoring (Routes logs, traces, dashboard, telemetry, and diagnostics work). Convient quand les ressources sont déjà levées et que vous voulez seulement les journaux ou le tableau de bord. Le matériau n'écrit ni URL de tableau de bord ni règles d'alerte ; la supervision doit passer par ce skill, pas un curl improvisé. Démarrer/arrêter des ressources a des effets de bord ; confirmez que l'environnement l'autorise avant d'exécuter.

Limites d'usage

aspire-init Creates a new Aspire project or adds an Aspire skeleton to an existing repo ; aspireify Wires an AppHost après aspire init. Cela change la structure du dépôt ; ne le traitez pas comme un contrôle en lecture seule. aspire-deployment inclut le démontage et exige une confirmation extra. Le matériau montre aussi npx skills add microsoft/aspire-skills et un ensemble de commandes /plugin ; ce sont d'autres entrées. Au premier essai, ne les mélangez pas avec le Aspire CLI en un seul chemin principal, et n'inférez pas qu'un client l'possède exclusivement.