Strumenti MCP integrati

PowerShell Universal include diversi strumenti MCP integrati che aiutano gli agenti di codifica a ispezionare le risorse PSU e a conoscere la superficie dei comandi locale. Sono disponibili dall'endpoint /api/v1/mcp.

Questi strumenti integrati sono separati dai suoi AI Tools personalizzati. In pratica, risultano più utili quando un agente deve ispezionare script, endpoint, app o la guida dei cmdlet prima di apportare una modifica.

Per accedervi da remoto, colleghi un client MCP a /api/v1/mcp e si autentichi con un token app PSU. Gli strumenti integrati richiedono l'accesso Administrator o Operator.

Flusso tipico

La maggior parte delle sessioni di codifica segue uno schema come questo:

1. Chiami list_resource_types per vedere quali tipi di risorse PSU sono disponibili.
2. Chiami list_resources per trovare lo script, l'endpoint, l'app o il workflow specifico di cui ha bisogno.
3. Chiami list_commands o list_app_commands per scoprire i cmdlet disponibili su quel server PSU.
4. Chiami command_help per una guida mirata sul cmdlet che intende utilizzare.
5. Chiami reload_resource dopo aver modificato la configurazione affinché PSU ricarichi la risorsa.

list_resource_types

Restituisce i tipi di risorsa disponibili sull'istanza PSU connessa, come script, endpoint, app e workflow.

Utilizzi prima questo strumento anziché indovinare i nomi dei tipi disponibili.

Esempio:

list_resource_types

list_resources

Elenca le risorse di un determinato tipo e le restituisce in formato JSON.

Parametri:

• type - Il tipo di risorsa da ispezionare. Utilizzi un valore restituito da list_resource_types.
• filter - Un filtro con caratteri jolly che corrisponde ai nomi o alle descrizioni delle risorse.

Esempio:

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

list_commands

Cerca i comandi in un modulo PowerShell installato sul server PSU.

Parametri:

• module - Il nome del modulo.
• name - Un filtro per il nome del comando. Sono supportati i caratteri jolly.

Di solito è seguito da command_help.

Esempio:

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

command_help

Restituisce le informazioni della guida per un comando disponibile sul server PSU.

Parametri:

• module - Il nome del modulo.
• command - Il comando da ispezionare.
• parameter - Nome del parametro o modello con caratteri jolly facoltativo.
• full - Include l'output completo della guida.
• examples - Include gli esempi.

Inizi con una guida mirata invece di richiedere sempre il testo completo della guida.

Esempio:

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

list_app_commands

Restituisce i cmdlet specifici delle app utilizzati per creare le app PSU, in particolare i comandi dei componenti UD e di interattività.

Parametro:

• filter - Un filtro con caratteri jolly per il nome del comando.

Esempio:

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

reload_resource

Ricarica un tipo di risorsa PSU dopo la modifica dei file o della configurazione.

Parametro:

• resourceType - Il tipo di risorsa da ricaricare.

Esempio:

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

Questo è particolarmente utile quando un agente modifica la configurazione tramite un checkout locale o un file system remoto e PSU deve quindi recepire la modifica.