> 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-chat.md).

# Chat de IA

Configure el AI Chat contextual, controle el acceso a los agentes y las herramientas y revise el historial de chat almacenado en PowerShell Universal.

AI Chat es un asistente contextual de la consola de administración de PowerShell Universal. Permite a un usuario autorizado seleccionar un agente de IA, pedirle que inspeccione o actualice el recurso actual, revisar su actividad de herramientas y recibir una respuesta en streaming. El chat está disponible en las páginas de la consola que ofrecen un contexto de recurso editable, como scripts, aplicaciones, API, programaciones y componentes del portal.

## Cómo funciona

El panel de chat transmite el tipo de recurso actual, el identificador del recurso, el ámbito del repositorio y el fichero principal al agente de IA seleccionado. El agente recibe instrucciones para permanecer dentro de ese ámbito y puede utilizar las herramientas configuradas para inspeccionar, actualizar y recargar el recurso.

Una sesión de chat tiene un ID de conversación. Borrar el chat inicia una nueva conversación en la consola. El panel de actividad de la sesión muestra las llamadas a herramientas y los cambios en ficheros realizados durante la sesión actual.

## Configurar AI Chat

1. Cree un agente de IA en **Build > AI > Agents**. Configure su proveedor, modelo, endpoint, credencial, instrucciones y las [AI Tools](/powershell-universal/es/inteligencia/ai-tools.md) que pueda invocar.
2. Active **Available in Chat** para el agente de IA.
3. Asigne roles al agente de IA cuando solo determinados usuarios deban poder seleccionarlo. Un agente sin roles asignados está disponible para todos los usuarios que tengan permiso de chat.
4. Conceda a los usuarios el permiso **Chat** `Read` o `Write`. Los usuarios también deben cumplir los requisitos de rol del agente seleccionado y los requisitos de rol del recurso que estén editando.

Si no hay ningún agente de IA apto habilitado para el chat, el panel de chat permanece no disponible para el usuario.

## Quién puede usar el chat

Un usuario solo puede usar AI Chat cuando se cumplen todas las condiciones siguientes:

* El usuario tiene el permiso **Chat** `Read` o `Write`.
* Al menos un agente de IA tiene **Available in Chat** activado.
* El usuario tiene un rol permitido por ese agente de IA, cuando el agente tiene restricciones de rol.
* El usuario está autorizado a acceder al recurso actual.

Los permisos de chat controlan el uso del panel. Los roles del agente de IA controlan qué agentes habilitados puede seleccionar un usuario.

## Herramientas disponibles para AI Chat

El agente de IA seleccionado puede invocar las AI Tools personalizadas configuradas en ese agente. Estas herramientas se ejecutan con su script, tiempo de espera y destino de ejecución configurados.

AI Chat también proporciona herramientas integradas contextuales para los usuarios que tienen el rol **Administrator**, **Operator** o **App Editor** y el permiso Chat `Read` o `Write`. Las herramientas disponibles dependen del recurso actual y del nivel de permisos.

| Capacidad                                                                            | Acceso de lectura                     | Acceso de escritura                   |
| ------------------------------------------------------------------------------------ | ------------------------------------- | ------------------------------------- |
| Detectar recursos y leer ficheros del repositorio                                    | Sí                                    | Sí                                    |
| Listar recursos, notificaciones, ficheros, contenido de ficheros y ayuda de comandos | Sí                                    | Sí                                    |
| Recargar el recurso actual                                                           | No                                    | Sí                                    |
| Crear, actualizar, mover o eliminar ficheros del repositorio                         | No                                    | Sí                                    |
| Inspeccionar un endpoint GET configurado para una aplicación                         | Solo contexto de aplicación           | Solo contexto de aplicación           |
| Buscar propiedades de controles del portal                                           | Solo contexto de componente de portal | Solo contexto de componente de portal |

Las operaciones integradas con ficheros están restringidas al ámbito del repositorio del recurso actual. No pueden salir de ese ámbito.

## Historial de chat y retención

PowerShell Universal almacena el historial de chat en su base de datos. Cada registro incluye la conversación y el agente seleccionado, el usuario, el contexto del recurso, los mensajes, el uso de tokens y el nombre, los argumentos, el resultado, el error, el estado y las marcas de tiempo de cada llamada a herramienta.

Los usuarios con el permiso **Chat History** `Read` pueden revisar las conversaciones persistidas en **Build > AI > Chat History**. El historial se conserva según la configuración general `GroomDays` y se elimina cuando supera ese periodo de retención. Tenga en cuenta esta política de retención cuando los prompts o los argumentos de las herramientas puedan contener información sensible.

## Páginas relacionadas

* [Agentes de IA](/powershell-universal/es/inteligencia/ai-agents.md)
* [AI Tools](/powershell-universal/es/inteligencia/ai-tools.md)
* [Built In MCP Tools](/powershell-universal/es/inteligencia/built-in-mcp-tools.md)


---

# 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-chat.md?ask=<question>&goal=<endgoal>
```

`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.
