> 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 Les agents 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, des autorisations et des outils IA optionnels pour permettre aux utilisateurs d'exécuter des invites répétables dans le système de tâches de PSU. Vous pouvez exécuter des agents depuis l'interface utilisateur, les flux de travail, l'API de gestion ou le module PowerShell Universal. ## Créer un agent IA ### Fournisseurs et modèles Accédez à Intelligence / AI Agents et cliquez sur Create AI Agent. Sélectionnez un fournisseur : * Anthropic * OpenAI * Custom Puis entrez 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é API afin que PSU puisse s'authentifier en votre nom. Pour `Custom`, fournissez une URL de point de terminaison absolue compatible OpenAI. Ceci est utile pour les modèles locaux ou auto-hébergés. Les points de terminaison personnalisés typiques incluent des passerelles locales telles que les API compatibles vLLM ou Ollama. ### Contexte Chaque agent peut inclure des instructions utilisées pour chaque invite. Après avoir créé l'agent, cliquez sur l'icône en forme 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 concises. Placez les données spécifiques à la requête dans l'invite elle-même plutôt que de les intégrer dans l'agent. ### Outils Les agents peuvent appeler des [outils IA](/powershell-universal/fr/intelligence/ai-tools.md) lors de leur exécution. Dans le champ AI Tools, assignez 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 de façon ad hoc, dans des flux de travail, via l'API de gestion ou avec des cmdlets PowerShell. ### Ad hoc 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 inspecter l'historique et la sortie des tâches depuis la page des tâches. ### Flux de travail Vous pouvez ajouter des étapes d'invite IA aux flux de travail. Les données de l'étape précédente sont disponibles pour l'agent dans le paramètre `PSUItem` sous forme de PowerShell CliXml. Par exemple, cette invite demande à l'agent d'inspecter 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é suivante du flux de travail sous forme de `PSUItem` pour une autre étape d'invite, ou de `$PSUItem` pour une étape PowerShell. ### Invoke-PSUAiAgent Utilisez le module PowerShell Universal pour créer, consulter, mettre à jour et invoquer des agents. Les cmdlets courants incluent : * `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 également exécuter un agent via 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 = 'Bearer ' } ` -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 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 IA pour interroger des données PSU ou effectuer des actions en exécutant des scripts PowerShell approuvés. L'accès aux outils est évalué au moment de l'exécution. Même si un agent est autorisé à s'exécuter, un appel d'outil échouera si l'appelant ne remplit pas les conditions 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 assigné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: ``` GET https://docs.devolutions.net/powershell-universal/fr/intelligence/ai-agents.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.