For the complete documentation index, see llms.txt. This page is also available as Markdown.

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:

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:

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:

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:

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:

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.

Ultimo aggiornamento

È stato utile?