Agents IA

Exécutez des invites d'IA directement dans PowerShell Universal.

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

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

$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 également exécuter un agent via l'API de gestion à /api/v1/aiagent/run.

Invoke-RestMethod -Method Post `
	-Uri 'http://localhost:5000/api/v1/aiagent/run' `
	-Headers @{ Authorization = 'Bearer <app-token>' } `
	-Body (@{
		agentName = 'SupportAgent'
		prompt    = 'Summarize the deployment status for today.'
	} | ConvertTo-Json) `
	-ContentType 'application/json'

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.