> 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/es/comandos-de-powershell/invoke-psuaiagent.md). # Invoke-PSUAiAgent ## SYNOPSIS Invoca un agente de IA de PowerShell Universal. ## SYNTAX ``` Invoke-PSUAiAgent [-AiAgent] [-Prompt] [-Parameters ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [-Wait] [-WaitTimeout ] [] ``` ## 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 ```powershell PS C:\> Invoke-PSUAiAgent -AiAgent SupportAgent -Prompt "Summarize the deployment status." ``` Inicia un trabajo de prompt para el agente de IA `SupportAgent`. ### Ejemplo 2 ```powershell 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 ```powershell 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 ```powershell 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`. ```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 Especifica el prompt que se enviará al agente de IA. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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`. --- # 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/es/comandos-de-powershell/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.