KI-Agenten

Mit AI Agents können Sie Prompt-Jobs direkt in PowerShell Universal ausführen. Ein Agent kombiniert ein Modell, Anbietereinstellungen, Anweisungen, Autorisierung und optionale AI Tools, sodass Benutzer wiederholbare Prompts innerhalb des PSU-Jobsystems ausführen können.

Sie können Agenten über die Benutzeroberfläche, Workflows, die Management API oder das PowerShell Universal-Modul ausführen.

Einen AI Agent erstellen

Anbieter und Modelle

Navigieren Sie zu Intelligence / AI Agents und klicken Sie auf Create AI Agent.

Wählen Sie einen Anbieter aus:

• Anthropic
• OpenAI
• Custom

Geben Sie dann den Modellnamen ein. Zum Beispiel:

• gpt-5.5
• claude-sonnet-4.6
• qwen3.6-27B

Geben Sie für gehostete Modelle eine API-Schlüsselvariable an, damit PSU sich in Ihrem Namen authentifizieren kann. Geben Sie für Custom eine absolute, OpenAI-kompatible Endpunkt-URL an. Dies ist nützlich für lokale oder selbst gehostete Modelle.

Typische benutzerdefinierte Endpunkte umfassen lokale Gateways wie vLLM oder Ollama-kompatible APIs.

Kontext

Jeder Agent kann Anweisungen enthalten, die für jeden Prompt verwendet werden. Klicken Sie nach dem Erstellen des Agenten auf das Stiftsymbol, um seine Markdown-Anweisungsdatei zu bearbeiten.

Verwenden Sie diese Datei für stabile Vorgaben wie:

• Tonfall und Schreibstil
• erwartetes Ausgabeformat
• betriebliche Regeln
• Referenzen auf verfügbare Tool-Namen

Halten Sie die Anweisungen fokussiert. Platzieren Sie anfragespezifische Daten im Prompt selbst, anstatt sie fest im Agenten zu verankern.

Tools

Agenten können während der Ausführung AI Tools aufrufen.

Weisen Sie im Feld AI Tools einen oder mehrere Tool-Namen oder Platzhaltermuster zu, wie zum Beispiel:

• Get Running Processes
• ticket_*
• weather*
• *

Lassen Sie das Feld leer, um den Tool-Zugriff für diesen Agenten zu deaktivieren.

Autorisierung

Wie andere PSU-Ressourcen können Agenten Rollen definieren, die zur Ausführung berechtigt sind. Der Aufrufer muss sowohl für den Agenten als auch für jedes Tool, das der Agent zu verwenden versucht, autorisiert sein.

Prompts ausführen

Sie können Prompts ad hoc, in Workflows, über die Management API oder mit PowerShell-Cmdlets ausführen.

Ad hoc

Klicken Sie auf das Ausführungssymbol neben einem Agenten, um einen Prompt-Job zu starten. Der Prompt wird als normaler PSU-Job ausgeführt, sodass Sie den Jobverlauf und die Ausgabe auf der Seite Jobs prüfen können.

Workflows

Sie können Workflows AI Prompt-Schritte hinzufügen. Daten aus dem vorherigen Schritt stehen dem Agenten im Parameter PSUItem als PowerShell-CliXml zur Verfügung.

Dieser Prompt fordert den Agenten beispielsweise auf, die Workflow-Eingabe zu prüfen und JSON zurückzugeben:

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

Die Ausgabe wird dann als PSUItem an die nächste Workflow-Aktivität für einen weiteren Prompt-Schritt oder als $PSUItem für einen PowerShell-Schritt übergeben.

Invoke-PSUAiAgent

Verwenden Sie das PowerShell Universal-Modul, um Agenten zu erstellen, zu überprüfen, zu aktualisieren und aufzurufen.

Häufig verwendete Cmdlets sind:

• Get-PSUAiAgent
• New-PSUAiAgent
• Set-PSUAiAgent
• Remove-PSUAiAgent
• Invoke-PSUAiAgent

Einen Agenten erstellen:

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

Einen Agenten aufrufen und auf die endgültige Antwort warten:

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

Zusätzliche Parameter an den Prompt-Job übergeben:

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

Diese zusätzlichen Parameter werden als CliXml serialisiert und dem Prompt-Kontext für den Agenten angefügt.

Management API

Sie können einen Agenten auch über die Management API unter /api/v1/aiagent/run ausführen.

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'

Die API gibt die erstellte Job-ID oder Run-ID zurück, mit der Sie die Job-Ausgabe lesen können.

Zugriff auf Tools

Agenten können AI Tools verwenden, um PSU-Daten abzufragen oder Aktionen durch die Ausführung genehmigter PowerShell-Skripte durchzuführen.

Der Tool-Zugriff wird zur Laufzeit ausgewertet. Selbst wenn ein Agent ausgeführt werden darf, schlägt ein Tool-Aufruf fehl, wenn der Aufrufer die Authentifizierungs- oder Rollenanforderungen des Tools nicht erfüllt.

Bei geplanten Workflow-Ausführungen ist der Aufrufer das PSU-Systemkonto, sodass geplante Ausführungen auf alle zugewiesenen Tools zugreifen können, deren Verwendung dem System erlaubt ist.