> 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/de/intelligence/ai-agents.md). # 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](/powershell-universal/de/intelligence/ai-tools.md) 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: {% 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 %} 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: {% 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 %} Einen Agenten aufrufen und auf die endgültige Antwort warten: {% code overflow="wrap" %} ```powershell Invoke-PSUAiAgent -AiAgent 'SupportAgent' ` -Prompt 'Summarize the last deployment and call out any failures.' ` -Wait ``` {% endcode %} Zusätzliche Parameter an den Prompt-Job übergeben: {% 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 %} 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. {% 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 %} 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. --- # 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/de/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.