> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/fr/commandes-powershell/invoke-psuaiagent.md). # Invoke-PSUAiAgent Invoke-PSUAiAgent démarre une tâche d'invite pour un agent IA PowerShell Universal et retourne la tâche créée afin d'en suivre la progression. ## SYNOPSIS Invoque un agent IA PowerShell Universal. ## SYNTAXE ``` Invoke-PSUAiAgent [-AiAgent] [-Prompt] [-Parameters ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [-Wait] [-WaitTimeout ] [] ``` ## 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 ```powershell 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 ```powershell 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 ```powershell 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 ```powershell 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`. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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`. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.devolutions.net/powershell-universal/fr/commandes-powershell/invoke-psuaiagent.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.