Agents IA

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 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 :

Return the top 5 processes by CPU usage as JSON.
The list of all processes is available in PSUItem as CliXml.

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 :

$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')

Invoquer un agent et attendre la réponse finale :

Invoke-PSUAiAgent -AiAgent 'SupportAgent' `
	-Prompt 'Summarize the last deployment and call out any failures.' `
	-Wait

Transmettre des paramètres supplémentaires à la tâche d'invite :

Invoke-PSUAiAgent -AiAgent 'SupportAgent' `
	-Prompt 'Draft a status update for the incident.' `
	-Parameters @{
		IncidentId = 42
		Customer   = 'Contoso'
		Severity   = 'High'
	} `
	-Wait

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.

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'

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.