Invoke-PSUAiAgent

ÜBERSICHT

Ruft einen PowerShell Universal KI-Agenten auf.

SYNTAX

Invoke-PSUAiAgent [-AiAgent] <Object> [-Prompt] <String> [-Parameters <Hashtable>] [-ComputerName <String>]
 [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate]
 [-Cookies] [-Wait] [-WaitTimeout <Int32>] [<CommonParameters>]

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

PS C:\> Invoke-PSUAiAgent -AiAgent SupportAgent -Prompt "Summarize the deployment status."

Startet einen Prompt-Job für den KI-Agenten SupportAgent.

Beispiel 2

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

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

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.