> 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/inteligencia/ai-agents.md). # Agentes de IA Los agentes de IA permiten ejecutar trabajos de prompts directamente en PowerShell Universal. Un agente combina un modelo, la configuración del proveedor, instrucciones, autorización y herramientas de IA opcionales, de modo que los usuarios puedan ejecutar prompts repetibles dentro del sistema de trabajos de PSU. Puede ejecutar agentes desde la interfaz de usuario, los flujos de trabajo, la API de gestión o el módulo de PowerShell Universal. ## Crear un agente de IA ### Proveedores y modelos Vaya a Intelligence / AI Agents y haga clic en Create AI Agent. Seleccione un proveedor: * Anthropic * OpenAI * Custom A continuación, introduzca el nombre del modelo. Por ejemplo: * `gpt-5.5` * `claude-sonnet-4.6` * `qwen3.6-27B` Para los modelos alojados, proporcione una variable con la clave de API para que PSU pueda autenticarse en su nombre. Para `Custom`, proporcione una URL de endpoint absoluta compatible con OpenAI. Esto resulta útil para modelos locales o autoalojados. Los endpoints personalizados habituales incluyen puertas de enlace locales como vLLM o API compatibles con Ollama. ### Contexto Cada agente puede incluir instrucciones que se utilizan en cada prompt. Después de crear el agente, haga clic en el icono del lápiz para editar su fichero de instrucciones en markdown. Utilice este fichero para directrices estables, como: * tono y estilo de redacción * formato de salida esperado * reglas operativas * referencias a los nombres de herramientas disponibles Mantenga las instrucciones centradas. Incluya los datos específicos de la solicitud en el propio prompt en lugar de integrarlos en el agente. ### Herramientas Los agentes pueden invocar [herramientas de IA](/powershell-universal/es/inteligencia/ai-tools.md) durante la ejecución. En el campo AI Tools, asigne uno o varios nombres de herramientas o patrones con comodines, como: * `Get Running Processes` * `ticket_*` * `weather*` * `*` Deje el campo vacío para desactivar el acceso a herramientas para ese agente. ### Autorización Como ocurre con otros recursos de PSU, los agentes pueden definir los roles que tienen permiso para ejecutarlos. El llamante debe estar autorizado tanto para el agente como para cualquier herramienta que el agente intente utilizar. ## Ejecutar prompts Puede ejecutar prompts de forma puntual, en flujos de trabajo, a través de la API de gestión o con cmdlets de PowerShell. ### Puntual Haga clic en el icono de ejecución situado junto a un agente para iniciar un trabajo de prompt. El prompt se ejecuta como un trabajo normal de PSU, por lo que puede consultar el historial de trabajos y la salida en la página Jobs. ### Flujos de trabajo Puede añadir pasos de AI Prompt a los flujos de trabajo. Los datos del paso anterior están disponibles para el agente en el parámetro `PSUItem` como CliXml de PowerShell. Por ejemplo, este prompt pide al agente que inspeccione la entrada del flujo de trabajo y devuelva JSON: {% 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 %} La salida se pasa después a la siguiente actividad del flujo de trabajo como `PSUItem` para otro paso de prompt, o como `$PSUItem` para un paso de PowerShell. ### Invoke-PSUAiAgent Utilice el módulo de PowerShell Universal para crear, revisar, actualizar e invocar agentes. Los cmdlets habituales incluyen: * `Get-PSUAiAgent` * `New-PSUAiAgent` * `Set-PSUAiAgent` * `Remove-PSUAiAgent` * `Invoke-PSUAiAgent` Crear un agente: {% 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 %} Invocar un agente y esperar la respuesta final: {% code overflow="wrap" %} ```powershell Invoke-PSUAiAgent -AiAgent 'SupportAgent' ` -Prompt 'Summarize the last deployment and call out any failures.' ` -Wait ``` {% endcode %} Pasar parámetros adicionales al trabajo de prompt: {% 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 %} Estos parámetros adicionales se serializan como CliXml y se añaden al contexto del prompt del agente. ### API de gestión También puede ejecutar un agente a través de la API de gestión en `/api/v1/aiagent/run`. {% 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 %} La API devuelve el ID del trabajo creado o el ID de ejecución, que puede utilizar para leer la salida del trabajo. ## Acceso a las herramientas Los agentes pueden utilizar herramientas de IA para consultar datos de PSU o realizar acciones ejecutando scripts de PowerShell aprobados. El acceso a las herramientas se evalúa en tiempo de ejecución. Aunque un agente tenga permiso para ejecutarse, una llamada a una herramienta fallará si el llamante no cumple los requisitos de autenticación o de rol de la herramienta. En las ejecuciones programadas de flujos de trabajo, el llamante es la cuenta del sistema de PSU, por lo que las ejecuciones programadas pueden acceder a cualquier herramienta asignada que el sistema tenga permiso para utilizar. --- # 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/inteligencia/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.