> 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/new-psuaiagent.md). # New-PSUAiAgent New-PSUAiAgent crée une nouvelle définition d'agent IA dans PowerShell Universal, y compris ses instructions, son modèle, sa clé d'API et ses outils autorisés. ## RÉSUMÉ Crée une nouvelle définition d'agent IA. ## SYNTAXE ``` New-PSUAiAgent [-Name] [-Description ] [-Instructions ] [-Model ] [-ApiKey ] [-Tool ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ## DESCRIPTION Construit une définition d'agent IA à partir des paramètres fournis et la conserve dans PowerShell Universal. L'agent créé peut définir des métadonnées de modèle, des instructions, une variable de clé d'API et les outils que l'agent peut invoquer. ## EXEMPLES ### Exemple 1 ```powershell PS C:\> New-PSUAiAgent -Name SupportAgent -Description "Tier 1 assistant" -Instructions "Answer from the knowledge base first." -Model gpt-4o-mini -Tool GetUsers,GetTickets ``` Crée un agent IA nommé SupportAgent qui peut utiliser les outils GetUsers et GetTickets. ## PARAMÈTRES ### -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'application à utiliser lors de l'authentification à 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 en cours. ```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 ``` ### -Instructions Spécifie les instructions système ou les directives de fonctionnement que l'agent IA suit lorsqu'il génère des 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: True Position: 0 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 aux 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 à 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, voir [about\_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). ## ENTRÉES ### Aucune ## SORTIES ### System.Object ## REMARQUES ## LIENS CONNEXES ## RÉSUMÉ Crée une nouvelle définition d'agent IA. ## SYNTAXE ```powershell New-PSUAiAgent -Name [-Description ] [-Instructions ] [-Model ] [-ApiKey ] [-Tool ] [-AvailableInChat] ``` ## DESCRIPTION Crée un agent avec ses métadonnées de modèle, ses instructions, sa variable de clé d'API et ses outils autorisés. Utilisez `-AvailableInChat` pour rendre l'agent sélectionnable dans les expériences de clavardage de l'administration et des applis générées. ## EXEMPLE ```powershell New-PSUAiAgent -Name SupportAgent -Model gpt-4o-mini -Instructions 'Answer from the knowledge base first.' -Tool GetTickets -AvailableInChat ``` ## PARAMÈTRES * **AvailableInChat** : Rend l'agent disponible dans les sélecteurs d'agent de l'interface de clavardage. * **Tool** : Noms des outils IA que l'agent peut invoquer. --- # 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/new-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.