Outils MCP intégrés

Outils MCP intégrés pour le développement avec PowerShell Universal.

PowerShell Universal inclut plusieurs outils MCP intégrés qui aident les agents de codage à inspecter les ressources PSU et à apprendre la surface de commandes locale. Ces outils sont disponibles depuis le point de terminaison /api/v1/mcp.

Ces outils intégrés sont distincts de vos outils IA personnalisés. En pratique, ils sont particulièrement utiles lorsqu'un agent doit inspecter des scripts, des points de terminaison, des applications ou l'aide sur des cmdlets avant d'effectuer une modification.

Pour y accéder à distance, connectez un client MCP à /api/v1/mcp et authentifiez-vous avec un jeton d'application PSU. Les outils intégrés requièrent un accès Administrator ou Operator.

Flux typique

La plupart des sessions de codage suivent un modèle semblable à celui-ci :

1. Appeler list_resource_types pour voir les types de ressources PSU disponibles.
2. Appeler list_resources pour trouver le script, le point de terminaison, l'application ou le flux de travail spécifique dont vous avez besoin.
3. Appeler list_commands ou list_app_commands pour découvrir les cmdlets disponibles sur ce serveur PSU.
4. Appeler command_help pour obtenir une aide ciblée sur le cmdlet que vous prévoyez d'utiliser.
5. Appeler reload_resource après avoir modifié la configuration afin que PSU recharge la ressource.

list_resource_types

Retourne les types de ressources disponibles sur l'instance PSU connectée, tels que les scripts, les points de terminaison, les applications et les flux de travail.

Utilisez cet outil en premier plutôt que de deviner les noms de types disponibles.

Exemple :

list_resource_types

list_resources

Répertorie les ressources d'un type donné et les retourne au format JSON.

Paramètres :

• type — Le type de ressource à inspecter. Utilisez une valeur retournée par list_resource_types.
• filter — Un filtre générique qui correspond aux noms ou descriptions de ressources.

Exemple :

{
	"type": "<resource type from list_resource_types>",
	"filter": "deploy*"
}

list_commands

Recherche des commandes dans un module PowerShell installé sur le serveur PSU.

Paramètres :

• module — Le nom du module.
• name — Un filtre sur le nom de commande. Les caractères génériques sont pris en charge.

Cette commande est généralement suivie de command_help.

Exemple :

{
	"module": "Universal",
	"name": "*PSUAi*"
}

command_help

Retourne des informations d'aide pour une commande disponible sur le serveur PSU.

Paramètres :

• module — Le nom du module.
• command — La commande à inspecter.
• parameter — Nom de paramètre ou motif générique optionnel.
• full — Inclure la sortie d'aide complète.
• examples — Inclure des exemples.

Commencez par une aide ciblée plutôt que de toujours demander le texte d'aide complet.

Exemple :

{
	"module": "Universal",
	"command": "Invoke-PSUAiAgent",
	"parameter": "Prompt",
	"full": false,
	"examples": true
}

list_app_commands

Retourne les cmdlets spécifiques aux applications utilisés pour construire des applications PSU, notamment les commandes de composants UD et d'interactivité.

Paramètre :

• filter — Un filtre générique pour le nom de commande.

Exemple :

{
	"filter": "New-UD*"
}

reload_resource

Recharge un type de ressource PSU après que des fichiers ou la configuration ont été modifiés.

Paramètre :

• resourceType — Le type de ressource à recharger.

Exemple :

{
	"resourceType": "<resource type from list_resource_types>"
}

Cet outil est particulièrement utile lorsqu'un agent modifie la configuration via une extraction locale ou un système de fichiers distant, et que PSU doit prendre en compte la modification.