> 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/powershell-befehle/invoke-psuaiagent.md). # Invoke-PSUAiAgent ## ÜBERSICHT Ruft einen PowerShell Universal KI-Agenten auf. ## SYNTAX ``` Invoke-PSUAiAgent [-AiAgent] [-Prompt] [-Parameters ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [-Wait] [-WaitTimeout ] [] ``` ## BESCHREIBUNG Startet einen Prompt-Job für einen KI-Agenten und gibt den erstellten Job zurück. Der Parameter `AiAgent` akzeptiert entweder den Namen eines KI-Agenten oder ein KI-Agenten-Objekt von `Get-PSUAiAgent`. Zusätzliche über `Parameters` bereitgestellte Werte werden serialisiert und dem Agenten-Job als ergänzende Parameter übergeben. PowerShell Universal erzwingt weiterhin die Ausführungsberechtigung sowie alle Rollen, die dem Ziel-KI-Agenten direkt zugewiesen sind. ## BEISPIELE ### Beispiel 1 ```powershell PS C:\> Invoke-PSUAiAgent -AiAgent SupportAgent -Prompt "Summarize the deployment status." ``` Startet einen Prompt-Job für den KI-Agenten `SupportAgent`. ### Beispiel 2 ```powershell PS C:\> Get-PSUAiAgent -Name SupportAgent | Invoke-PSUAiAgent -Prompt "Draft a response for the ticket." -Parameters @{ TicketId = 42; Customer = 'Contoso' } ``` Ruft das über die Pipeline übergebene KI-Agenten-Objekt auf und übergibt zusätzliche Job-Parameter, die der Agent beim Erstellen seiner Antwort verwenden kann. ### Beispiel 3 ```powershell PS C:\> Invoke-PSUAiAgent -AiAgent SupportAgent -Prompt "Summarize the deployment status." -Wait ``` Startet einen Prompt-Job für den KI-Agenten `SupportAgent` und wartet auf dessen Abschluss, wobei die Antwort des Agenten anstelle des Job-Objekts zurückgegeben wird. ### Beispiel 4 ```powershell PS C:\> Invoke-PSUAiAgent -AiAgent SupportAgent -Prompt "Summarize the deployment status." -Wait -WaitTimeout 60 ``` Wartet bis zu 60 Sekunden auf den Abschluss des Agenten-Jobs. Löst eine Timeout-Ausnahme aus, wenn der Job nicht innerhalb der vorgegebenen Zeit abgeschlossen wird. ## PARAMETER ### -AiAgent Gibt den aufzurufenden KI-Agenten an. Sie können den Namen des KI-Agenten direkt übergeben oder ein von `Get-PSUAiAgent` zurückgegebenes KI-Agenten-Objekt über die Pipeline übergeben. ```yaml Type: Object Parameter Sets: (All) Aliases: Name Required: True Position: 0 Default value: None Accept pipeline input: True (ByValue) Accept wildcard characters: False ``` ### -Prompt Gibt den Prompt an, der an den KI-Agenten gesendet werden soll. ```yaml Type: String Parameter Sets: (All) Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Parameters Gibt zusätzliche benutzerdefinierte Parameter an, die an den KI-Agenten-Job übergeben werden. Jeder Schlüssel wird zu einem Job-Parameter und jeder Wert wird vor der Ausführung als PowerShell CliXml serialisiert. ```yaml Type: Hashtable Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ComputerName Die HTTP-Adresse des PSU Management API-Servers. ```yaml Type: String Parameter Sets: (All) Aliases: Uri Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -AppToken Ein App-Token für den Zugriff auf die PSU Management API. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Credential Gibt die Anmeldeinformationen an, die bei der Authentifizierung bei der PSU Management API verwendet werden. ```yaml Type: PSCredential Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -UseDefaultCredentials Verwendet die aktuelle Windows-Identität bei der Authentifizierung bei der PSU Management API. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Integrated Führt den Befehl intern aus, anstatt die Management API zu verwenden. Dies funktioniert nur bei der Ausführung innerhalb von PowerShell Universal. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -TrustCertificate Deaktiviert die TLS-Zertifikatsvalidierung für Management API-Anfragen. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Cookies Verwendet den aktuellen PSU-Cookie-Container für die Authentifizierung. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Wait Wartet auf den Abschluss des KI-Agenten-Jobs und gibt dessen Ausgabe anstelle des Job-Objekts zurück. Wenn angegeben, blockiert der Befehl, bis der Job abgeschlossen ist oder das Timeout erreicht wird. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -WaitTimeout Gibt die maximale Anzahl von Sekunden an, die bei Verwendung von `-Wait` auf den Abschluss des Jobs gewartet wird. Wenn das Timeout erreicht wird, löst der Befehl eine Timeout-Ausnahme aus. ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: 0 Accept pipeline input: False Accept wildcard characters: False ``` ## EINGABEN ### System.Object Sie können ein KI-Agenten-Objekt von `Get-PSUAiAgent` über die Pipeline übergeben oder eine Agentennamen-Zeichenfolge übergeben. ## AUSGABEN ### PowerShellUniversal.Job Gibt den für den KI-Agenten-Aufruf erstellten Prompt-Job zurück. ## HINWEISE Zusätzliche Verbindungsparameter werden von `GrpcCommand` geerbt. --- # 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/powershell-befehle/invoke-psuaiagent.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.