> 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/intelligence/ai-agents.md). # Agents IA Créez et exécutez des agents IA dans PowerShell Universal pour exécuter des tâches de prompt avec des fournisseurs, des modèles, des instructions et des outils IA configurables. Les agents d'IA vous permettent d'exécuter des tâches d'invite directement dans PowerShell Universal. Un agent combine un modèle, des paramètres de fournisseur, des instructions, une autorisation et des outils d'IA facultatifs afin que les utilisateurs puissent exécuter des invites reproductibles à l'intérieur du système de tâches de PSU. Vous pouvez exécuter des agents à partir de l'interface utilisateur, des flux de travail, de l'API de gestion ou du module PowerShell Universal. ## Créer un agent d'IA ### Fournisseurs et modèles Accédez à **Build > AI > Agents** et cliquez sur Create AI Agent. Sélectionnez un fournisseur : * Anthropic * OpenAI * Personnalisé Entrez ensuite le nom du modèle. Par exemple : * `gpt-5.5` * `claude-sonnet-4.6` * `qwen3.6-27B` Pour les modèles hébergés, fournissez une variable de clé d'API afin que PSU puisse s'authentifier en votre nom. Pour `Custom`, fournissez une URL de terminal absolue compatible avec OpenAI. Ceci est utile pour les modèles locaux ou auto-hébergés. Les terminaux personnalisés typiques comprennent des passerelles locales telles que vLLM ou les API compatibles avec Ollama. ### Contexte Chaque agent peut inclure des instructions qui sont utilisées pour chaque invite. Après avoir créé l'agent, cliquez sur l'icône de crayon pour modifier son fichier d'instructions markdown. Utilisez ce fichier pour des directives stables telles que : * le ton et le style d'écriture * le format de sortie attendu * les règles opérationnelles * les références aux noms d'outils disponibles Gardez les instructions ciblées. Placez les données propres à une demande dans l'invite elle-même plutôt que de les intégrer à l'agent. ### Outils Les agents peuvent appeler des [outils d'IA](/powershell-universal/fr/intelligence/ai-tools.md) pendant l'exécution. Dans le champ Outils d'IA, attribuez un ou plusieurs noms d'outils ou motifs génériques tels que : * `Get Running Processes` * `ticket_*` * `weather*` * `*` Laissez le champ vide pour désactiver l'accès aux outils pour cet agent. ### Autorisation Comme les autres ressources PSU, les agents peuvent définir les rôles autorisés à les exécuter. L'appelant doit être autorisé à la fois pour l'agent et pour tout outil que l'agent tente d'utiliser. ## Exécution des invites Vous pouvez exécuter des invites ponctuellement, dans des flux de travail, par l'intermédiaire de l'API de gestion ou avec des applets de commande PowerShell. ### Ponctuel Cliquez sur l'icône d'exécution à côté d'un agent pour démarrer une tâche d'invite. L'invite s'exécute comme une tâche PSU normale, vous pouvez donc examiner l'historique et la sortie des tâches à partir de la page Tâches. ### Flux de travail Vous pouvez ajouter des étapes d'invite d'IA aux flux de travail. Les données de l'étape précédente sont accessibles à l'agent dans le paramètre `PSUItem` sous forme de CliXml PowerShell. Par exemple, cette invite demande à l'agent d'examiner l'entrée du flux de travail et de retourner du JSON : {% code overflow="wrap" %} ``` Return the top 5 processes by CPU usage as JSON. The list of all processes is available in PSUItem as CliXml. ``` {% endcode %} La sortie est ensuite transmise à l'activité de flux de travail suivante en tant que `PSUItem` pour une autre étape d'invite ou `$PSUItem` pour une étape PowerShell. ### Invoke-PSUAiAgent Utilisez le module PowerShell Universal pour créer, examiner, mettre à jour et invoquer des agents. Les applets de commande courantes comprennent : * `Get-PSUAiAgent` * `New-PSUAiAgent` * `Set-PSUAiAgent` * `Remove-PSUAiAgent` * `Invoke-PSUAiAgent` Créer un agent : {% code overflow="wrap" %} ```powershell $apiKey = Get-PSUVariable -Name 'OpenAIKey' New-PSUAiAgent -Name 'SupportAgent' ` -Description 'Summarizes incidents and drafts operator-facing responses.' ` -Provider OpenAI ` -Model 'gpt-5.5' ` -ApiKey $apiKey ` -Tool @('ticket_*', 'Get Running Processes') ` -Role @('HelpDesk', 'Operator') ``` {% endcode %} Invoquer un agent et attendre la réponse finale : {% code overflow="wrap" %} ```powershell Invoke-PSUAiAgent -AiAgent 'SupportAgent' ` -Prompt 'Summarize the last deployment and call out any failures.' ` -Wait ``` {% endcode %} Transmettre des paramètres supplémentaires à la tâche d'invite : {% code overflow="wrap" %} ```powershell Invoke-PSUAiAgent -AiAgent 'SupportAgent' ` -Prompt 'Draft a status update for the incident.' ` -Parameters @{ IncidentId = 42 Customer = 'Contoso' Severity = 'High' } ` -Wait ``` {% endcode %} Ces paramètres supplémentaires sont sérialisés en CliXml et ajoutés au contexte de l'invite pour l'agent. ### API de gestion Vous pouvez aussi exécuter un agent par l'intermédiaire de l'API de gestion à `/api/v1/aiagent/run`. {% code overflow="wrap" %} ```powershell Invoke-RestMethod -Method Post ` -Uri 'http://localhost:5000/api/v1/aiagent/run' ` -Headers @{ Authorization = '******' } ` -Body (@{ agentName = 'SupportAgent' prompt = 'Summarize the deployment status for today.' } | ConvertTo-Json) ` -ContentType 'application/json' ``` {% endcode %} L'API retourne l'ID de tâche ou l'ID d'exécution créé, que vous pouvez utiliser pour lire la sortie de la tâche. ## Accès aux outils Les agents peuvent utiliser des outils d'IA pour interroger des données PSU ou agir en exécutant des scripts PowerShell approuvés. L'accès aux outils est évalué à l'exécution. Même si un agent est autorisé à s'exécuter, un appel d'outil échouera si l'appelant ne satisfait pas aux exigences d'authentification ou de rôle de l'outil. Pour les exécutions de flux de travail planifiées, l'appelant est le compte système PSU, de sorte que les exécutions planifiées peuvent accéder à tous les outils attribués que le système est autorisé à utiliser. --- # 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/intelligence/ai-agents.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.