Invoke-PSUAiAgent

SYNOPSIS

Invoca un agente de IA de PowerShell Universal.

SYNTAX

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

DESCRIPTION

Inicia un trabajo de prompt para un agente de IA y devuelve el trabajo creado. El parámetro AiAgent acepta tanto el nombre de un agente de IA como un objeto de agente de IA de Get-PSUAiAgent. Los valores adicionales proporcionados mediante Parameters se serializan y se pasan al trabajo del agente como parámetros complementarios. PowerShell Universal sigue aplicando el permiso de ejecución y cualquier rol asignado directamente al agente de IA de destino.

EXAMPLES

Ejemplo 1

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

Inicia un trabajo de prompt para el agente de IA SupportAgent.

Ejemplo 2

PS C:\> Get-PSUAiAgent -Name SupportAgent | Invoke-PSUAiAgent -Prompt "Draft a response for the ticket." -Parameters @{ TicketId = 42; Customer = 'Contoso' }

Invoca el objeto de agente de IA canalizado y pasa parámetros de trabajo adicionales que el agente puede utilizar al construir su respuesta.

Ejemplo 3

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

Inicia un trabajo de prompt para el agente de IA SupportAgent y espera a que se complete, devolviendo la respuesta del agente en lugar del objeto de trabajo.

Ejemplo 4

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

Espera hasta 60 segundos a que se complete el trabajo del agente. Lanza una excepción de tiempo de espera si el trabajo no finaliza en el tiempo asignado.

PARAMETERS

-AiAgent

Especifica el agente de IA que se debe invocar. Puede pasar el nombre del agente de IA directamente o canalizar un objeto de agente de IA devuelto por Get-PSUAiAgent.

Type: Object
Parameter Sets: (All)
Aliases: Name

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Prompt

Especifica el prompt que se enviará al agente de IA.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Parameters

Especifica parámetros adicionales definidos por el usuario que se pasarán al trabajo del agente de IA. Cada clave se convierte en un parámetro del trabajo y cada valor se serializa como PowerShell CliXml antes de la ejecución.

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ComputerName

La dirección HTTP del servidor de la API de gestión de PSU.

Type: String
Parameter Sets: (All)
Aliases: Uri

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AppToken

Un token de aplicación para acceder a la API de gestión de PSU.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Credential

Especifica la credencial utilizada al autenticarse en la API de gestión de PSU.

Type: PSCredential
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UseDefaultCredentials

Utiliza la identidad de Windows actual al autenticarse en la API de gestión de PSU.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Integrated

Ejecuta el comando internamente en lugar de utilizar la API de gestión. Esto solo funciona cuando se ejecuta dentro de PowerShell Universal.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TrustCertificate

Deshabilita la validación del certificado TLS para las solicitudes a la API de gestión.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Cookies

Utiliza el contenedor de cookies actual de PSU para la autenticación.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Wait

Espera a que se complete el trabajo del agente de IA y devuelve su salida en lugar del objeto de trabajo. Cuando se especifica, el comando se bloqueará hasta que el trabajo finalice o se alcance el tiempo de espera.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WaitTimeout

Especifica el número máximo de segundos que se esperará a que se complete el trabajo al utilizar -Wait. Si se alcanza el tiempo de espera, el comando lanza una excepción de tiempo de espera.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

INPUTS

System.Object

Puede canalizar un objeto de agente de IA desde Get-PSUAiAgent o pasar una cadena con el nombre del agente.

OUTPUTS

PowerShellUniversal.Job

Devuelve el trabajo de prompt creado para la invocación del agente de IA.

NOTES

Los parámetros de conexión adicionales se heredan de GrpcCommand.