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 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:

Return the top 5 processes by CPU usage as JSON.
The list of all processes is available in PSUItem as CliXml.

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:

$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')

Invocar un agente y esperar la respuesta final:

Invoke-PSUAiAgent -AiAgent 'SupportAgent' `
	-Prompt 'Summarize the last deployment and call out any failures.' `
	-Wait

Pasar parámetros adicionales al trabajo de prompt:

Invoke-PSUAiAgent -AiAgent 'SupportAgent' `
	-Prompt 'Draft a status update for the incident.' `
	-Parameters @{
		IncidentId = 42
		Customer   = 'Contoso'
		Severity   = 'High'
	} `
	-Wait

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.

Invoke-RestMethod -Method Post `
	-Uri 'http://localhost:5000/api/v1/aiagent/run' `
	-Headers @{ Authorization = 'Bearer <app-token>' } `
	-Body (@{
		agentName = 'SupportAgent'
		prompt    = 'Summarize the deployment status for today.'
	} | ConvertTo-Json) `
	-ContentType 'application/json'

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.