Invoke-PSUAiAgent

SYNOPSIS

Richiama un agente IA di PowerShell Universal.

SYNTAX

Invoke-PSUAiAgent [-AiAgent] <Object> [-Prompt] <String> [-Parameters <Hashtable>] [-ComputerName <String>]
 [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate]
 [-Cookies] [-Wait] [-WaitTimeout <Int32>] [<CommonParameters>]

DESCRIPTION

Avvia un job di prompt per un agente IA e restituisce il job creato. Il parametro AiAgent accetta il nome di un agente IA oppure un oggetto agente IA restituito da Get-PSUAiAgent. I valori aggiuntivi forniti tramite Parameters vengono serializzati e passati al job dell'agente come parametri supplementari. PowerShell Universal applica comunque l'autorizzazione di esecuzione e tutti i ruoli assegnati direttamente all'agente IA di destinazione.

EXAMPLES

Esempio 1

PS C:\> Invoke-PSUAiAgent -AiAgent SupportAgent -Prompt "Summarize the deployment status."

Avvia un job di prompt per l'agente IA SupportAgent.

Esempio 2

PS C:\> Get-PSUAiAgent -Name SupportAgent | Invoke-PSUAiAgent -Prompt "Draft a response for the ticket." -Parameters @{ TicketId = 42; Customer = 'Contoso' }

Richiama l'oggetto agente IA inviato tramite pipeline e passa parametri di job aggiuntivi che l'agente può utilizzare durante la creazione della risposta.

Esempio 3

PS C:\> Invoke-PSUAiAgent -AiAgent SupportAgent -Prompt "Summarize the deployment status." -Wait

Avvia un job di prompt per l'agente IA SupportAgent e ne attende il completamento, restituendo la risposta dell'agente anziché l'oggetto job.

Esempio 4

PS C:\> Invoke-PSUAiAgent -AiAgent SupportAgent -Prompt "Summarize the deployment status." -Wait -WaitTimeout 60

Attende fino a 60 secondi il completamento del job dell'agente. Genera un'eccezione di timeout se il job non termina entro il tempo previsto.

PARAMETERS

-AiAgent

Specifica l'agente IA da richiamare. È possibile passare direttamente il nome dell'agente IA oppure inviare tramite pipeline un oggetto agente IA restituito da Get-PSUAiAgent.

Type: Object
Parameter Sets: (All)
Aliases: Name

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Prompt

Specifica il prompt da inviare all'agente IA.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Parameters

Specifica parametri aggiuntivi definiti dall'utente da passare al job dell'agente IA. Ogni chiave diventa un parametro del job e ogni valore viene serializzato come PowerShell CliXml prima dell'esecuzione.

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ComputerName

L'indirizzo HTTP del server dell'API di gestione PSU.

Type: String
Parameter Sets: (All)
Aliases: Uri

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AppToken

Un token dell'app per accedere all'API di gestione PSU.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Credential

Specifica la credenziale utilizzata per l'autenticazione all'API di gestione PSU.

Type: PSCredential
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UseDefaultCredentials

Utilizza l'identità Windows corrente per l'autenticazione all'API di gestione PSU.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Integrated

Esegue il comando internamente anziché utilizzare l'API di gestione. Questo funziona solo durante l'esecuzione all'interno di PowerShell Universal.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TrustCertificate

Disattiva la convalida del certificato TLS per le richieste all'API di gestione.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Cookies

Utilizza il contenitore di cookie PSU corrente per l'autenticazione.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Wait

Attende il completamento del job dell'agente IA e ne restituisce l'output anziché l'oggetto job. Se specificato, il comando rimane bloccato fino al termine del job o al raggiungimento del timeout.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WaitTimeout

Specifica il numero massimo di secondi di attesa per il completamento del job quando si utilizza -Wait. Se il timeout viene raggiunto, il comando genera un'eccezione di timeout.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

INPUTS

System.Object

È possibile inviare tramite pipeline un oggetto agente IA da Get-PSUAiAgent oppure passare una stringa con il nome dell'agente.

OUTPUTS

PowerShellUniversal.Job

Restituisce il job di prompt creato per la chiamata dell'agente IA.

NOTES

I parametri di connessione aggiuntivi sono ereditati da GrpcCommand.