Invoke-PSUAiAgent

SYNOPSIS

Invoque un agent IA PowerShell Universal.

SYNTAXE

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

DESCRIPTION

Démarre une tâche d'invite pour un agent IA et retourne la tâche créée. Le paramètre AiAgent accepte soit le nom d'un agent IA, soit un objet d'agent IA provenant de Get-PSUAiAgent. Les valeurs additionnelles fournies par Parameters sont sérialisées et transmises à la tâche de l'agent en tant que paramètres supplémentaires. PowerShell Universal applique toujours la permission d'exécution ainsi que tous les rôles assignés directement à l'agent IA ciblé.

EXEMPLES

Exemple 1

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

Démarre une tâche d'invite pour l'agent IA SupportAgent.

Exemple 2

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

Invoque l'objet d'agent IA transmis par le pipeline et passe des paramètres de tâche additionnels que l'agent peut utiliser lors de la construction de sa réponse.

Exemple 3

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

Démarre une tâche d'invite pour l'agent IA SupportAgent et attend qu'elle se termine, retournant la réponse de l'agent au lieu de l'objet de tâche.

Exemple 4

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

Attend jusqu'à 60 secondes que la tâche de l'agent se termine. Lève une exception de délai d'attente si la tâche ne se termine pas dans le temps imparti.

PARAMÈTRES

-AiAgent

Spécifie l'agent IA à invoquer. Vous pouvez passer le nom de l'agent IA directement ou transmettre par pipeline un objet d'agent IA retourné par 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

Spécifie l'invite à envoyer à l'agent IA.

Type: String
Parameter Sets: (All)
Aliases:

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

-Parameters

Spécifie des paramètres additionnels définis par l'utilisateur à passer à la tâche de l'agent IA. Chaque clé devient un paramètre de tâche et chaque valeur est sérialisée en PowerShell CliXml avant l'exécution.

Type: Hashtable
Parameter Sets: (All)
Aliases:

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

-ComputerName

L'adresse HTTP du serveur de l'API de gestion 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 jeton d'appli pour accéder à l'API de gestion PSU.

Type: String
Parameter Sets: (All)
Aliases:

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

-Credential

Spécifie l'identifiant utilisé lors de l'authentification à l'API de gestion PSU.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-UseDefaultCredentials

Utilise l'identité Windows actuelle lors de l'authentification à l'API de gestion PSU.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Integrated

Exécute la commande à l'interne plutôt qu'en utilisant l'API de gestion. Cela ne fonctionne que lors de l'exécution dans PowerShell Universal.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-TrustCertificate

Désactive la validation du certificat TLS pour les requêtes de l'API de gestion.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Cookies

Utilise le conteneur de témoins PSU actuel pour l'authentification.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Wait

Attend que la tâche de l'agent IA se termine et retourne sa sortie plutôt que l'objet de tâche. Lorsque spécifié, la commande bloque jusqu'à ce que la tâche se termine ou que le délai d'attente soit atteint.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-WaitTimeout

Spécifie le nombre maximal de secondes à attendre que la tâche se termine lors de l'utilisation de -Wait. Si le délai d'attente est atteint, la commande lève une exception de délai d'attente.

Type: Int32
Parameter Sets: (All)
Aliases:

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

ENTRÉES

System.Object

Vous pouvez transmettre par pipeline un objet d'agent IA provenant de Get-PSUAiAgent ou passer une chaîne du nom de l'agent.

SORTIES

PowerShellUniversal.Job

Retourne la tâche d'invite créée pour l'invocation de l'agent IA.

NOTES

Les paramètres de connexion additionnels sont hérités de GrpcCommand.