> 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/set-psuaiagent.md). # Set-PSUAiAgent Set-PSUAiAgent met à jour un agent IA existant dans PowerShell Universal, en modifiant uniquement les champs que vous fournissez, comme les instructions, le modèle ou les outils. ## SYNOPSIS Met à jour une définition d'agent IA existante. ## SYNTAXE ### Id ``` Set-PSUAiAgent [-Id] [-Name ] [-Description ] [-Instructions ] [-Model ] [-ApiKey ] [-Tool ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### AiAgent ``` Set-PSUAiAgent [-AiAgent] [-Name ] [-Description ] [-Instructions ] [-Model ] [-ApiKey ] [-Tool ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ## DESCRIPTION Charge un agent IA par Id ou par objet de pipeline et met à jour uniquement les champs fournis à l'applet de commande. Cela vous permet d'effectuer des modifications partielles sans reconstruire la définition complète de l'agent. ## EXEMPLES ### Exemple 1 ```powershell PS C:\> Set-PSUAiAgent -Id 12 -Instructions "Escalate billing issues to humans." -Tool GetInvoices,CreateTicket ``` Met à jour l'agent 12 avec de nouvelles instructions et remplace sa liste d'outils. ## PARAMÈTRES ### -AiAgent Spécifie l'agent IA à cibler. ```yaml Type: AiAgent Parameter Sets: AiAgent Aliases: Required: True Position: 0 Default value: None Accept pipeline input: True (ByValue) Accept wildcard characters: False ``` ### -ApiKey Spécifie la variable PSU qui contient la clé d'API utilisée par l'agent IA. ```yaml Type: Variable Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -AppToken Spécifie le jeton d'appli à utiliser lors de l'authentification auprès de l'API de gestion de PowerShell Universal. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ComputerName Spécifie l'URL ou le nom d'hôte de l'instance PowerShell Universal cible. Les noms d'hôte simples sont normalisés en une URL `http://:5000`. ```yaml Type: String Parameter Sets: (All) Aliases: Uri Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Cookies Réutilise et conserve les témoins d'authentification pour la session PowerShell actuelle. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Credential Spécifie les identifiants à utiliser pour l'authentification de base auprès de l'API de gestion de PowerShell Universal. ```yaml Type: PSCredential Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Description Spécifie une description pour la ressource. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Id Spécifie l'Id numérique de la ressource. ```yaml Type: Int64 Parameter Sets: Id Aliases: Required: True Position: 0 Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Instructions Spécifie les instructions système ou les directives de fonctionnement que l'agent IA suit lors de la génération de réponses. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Integrated Utilise le client de gestion intégré en cours de processus lorsque l'applet de commande s'exécute 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 ``` ### -Model Spécifie l'identifiant du modèle IA que l'agent doit utiliser pour les complétions. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Name Spécifie le nom de la ressource. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Tool Spécifie les noms des outils IA que l'agent peut utiliser. ```yaml Type: String[] Parameter Sets: (All) Aliases: Tools Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -TrustCertificate Permet les connexions à des serveurs dont les certificats TLS ne sont pas approuvés. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -UseDefaultCredentials Utilise les identifiants Windows actuels lors de l'authentification auprès 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 ``` ### CommonParameters Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable et -ProgressAction. Pour plus d'information, consultez [about\_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). ## ENTRÉES ### PowerShellUniversal.Models.Intelligence.AiAgent ## SORTIES ### System.Object ## NOTES ## LIENS CONNEXES ## SYNOPSIS Met à jour une définition d'agent IA existante. ## SYNTAXE ```powershell Set-PSUAiAgent -Id [-Name ] [-Description ] [-Instructions ] [-Model ] [-ApiKey ] [-Tool ] [-AvailableInChat] Set-PSUAiAgent -AiAgent [-Name ] [-Description ] [-Instructions ] [-Model ] [-ApiKey ] [-Tool ] [-AvailableInChat] ``` ## DESCRIPTION Met à jour uniquement les champs fournis pour l'agent. `-AvailableInChat` détermine si l'agent peut être sélectionné dans les expériences de clavardage de l'administration et des applis générées. ## EXEMPLE ```powershell Set-PSUAiAgent -Id 12 -AvailableInChat -Tool GetTickets,CreateTicket ``` --- # 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/set-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.