Asistente de IA
El asistente de IA es un widget en la esquina inferior derecha del panel de administración. En su forma minimizada, es un botón esférico; al hacer clic en él, se abre el panel del asistente. Mientras el asistente está trabajando, la esfera pulsa, lo que indica que el agente aún está realizando una tarea, incluso si el panel está cerrado.
En el panel hay dos pestañas (en la interfaz en español: "Documentación" y "Agente MCP"):
| Pestaña | Qué hace |
|---|---|
| documentación | responde preguntas sobre la documentación de OneEntry — no cambia nada en el proyecto |
| Agente MCP | realiza la tarea descrita en palabras simples: encuentra la operación necesaria de la API de Admin, crea y modifica los datos del proyecto |
Las pestañas tienen historias separadas: las preguntas sobre la documentación no se incluyen en la conversación con el agente, y viceversa.
Cada uso del agente consume recursos de la cuenta de IA seleccionada en el panel: el agente consulta el modelo varias veces para una sola tarea — busca la operación, la analiza, la invoca, verifica el resultado. El gasto por cada uso se muestra debajo de la respuesta, y el saldo total se encuentra en la pestaña Configuración → Agentes de IA.
Panel del asistente
En la parte superior del panel, a la derecha de las pestañas, hay tres botones:
- expandir / contraer — hace que el panel sea más ancho o lo devuelve a su tamaño normal;
- borrar historial — limpia la conversación de la pestaña abierta. El botón está inactivo mientras no haya nada en la conversación o el asistente aún esté respondiendo;
- cerrar — minimiza el panel de nuevo a la esfera. El panel se cierra también al hacer clic en cualquier lugar fuera de él.
Pestaña del agente MCP
El agente realiza la tarea descrita en sus propias palabras, por ejemplo, "crea una página sobre entrega" o "crea productos a partir de esta tabla". Trabaja con la API de Admin a través de un conjunto de herramientas: busca la operación necesaria, analiza sus parámetros, la invoca, carga archivos. Entre las herramientas también hay búsqueda en la documentación de OneEntry — el agente lee la documentación por sí mismo si necesita entender cómo funciona el módulo.
El agente actúa en nombre del administrador actual y con sus derechos: lo que no está disponible para usted, tampoco está disponible para el agente. La eliminación de datos está prohibida para el agente, y las operaciones protegidas solo se realizan después de su confirmación (ver más abajo).
Selección del agente y modelo
En la parte superior de la pestaña, en los campos Agente y Modelo, se seleccionan la cuenta de IA y el modelo que realizarán la tarea. Las cuentas se obtienen de Configuración → Agentes de IA. En la lista solo hay modelos que pueden invocar herramientas: sin esto, el agente no puede trabajar con la API.
Si no hay ninguna cuenta de IA en el proyecto, en lugar de la selección, el panel muestra una advertencia de que el agente de IA no está configurado y debe ser creado en la configuración. Cree una cuenta en la pestaña Configuración → Agentes de IA.
Ejecución de la tarea
- Describa la tarea en el campo de solicitud.
- Si es necesario, adjunte un archivo con el botón de clip — por ejemplo, una tabla con productos. Se puede adjuntar un solo archivo a la solicitud. Los tipos de archivos permitidos y el tamaño máximo son establecidos por el servidor; si el archivo es demasiado grande, el panel no lo aceptará y sugerirá dividirlo en partes. Solo se puede adjuntar una imagen si el modelo seleccionado puede leer imágenes; de lo contrario, elija otro modelo o adjunte un documento.
- Haga clic en el botón de ejecución (en la interfaz en español: "Ejecutar"). Mientras el agente trabaja, el botón se convierte en el botón de cancelación ("Cancelar") — este detiene la ejecución.
Mientras la tarea se está ejecutando, se pueden ver los pasos del agente en el feed: qué operación está buscando, cuál está invocando, qué archivo está cargando. Se puede expandir el paso con detalles haciendo clic. Cuando el agente termine, aparecerá su respuesta debajo de los pasos, y debajo de la respuesta, el gasto de la ejecución: el número de tokens y el costo en dólares.
El agente tiene en cuenta los últimos intercambios completados en la conversación, por lo que la siguiente tarea se puede formular como una continuación de la anterior.
Confirmación de operaciones protegidas
Antes de una operación protegida, el agente se detiene y muestra una tarjeta con la solicitud de permiso. En ella están el método y la dirección de la solicitud, los datos que se enviarán y lo que actualmente está en esa dirección. La decisión se toma sobre la propia solicitud, no sobre el resumen del modelo:
- botón de permiso (en la interfaz en español: "Permitir") — el agente ejecuta la operación;
- botón de rechazo ("Rechazar") — la operación no se ejecuta.
Si la respuesta no llega al servidor, la tarjeta informará sobre esto, y los botones volverán a estar disponibles.
Lo que es importante saber
- Cerrar el panel no cancela la tarea. El agente continúa trabajando, los pasos y la respuesta aparecerán cuando se vuelva a abrir el panel. Pero después de cerrar el panel o cambiar de pestaña, no se puede detener una tarea ya iniciada desde el panel, y el texto de la solicitud no enviado y el archivo adjunto se perderán.
- El historial se almacena solo en la memoria de la página. Después de recargar la página, la conversación con el agente se pierde. Cerrar la pestaña del navegador o recargar durante el trabajo del agente interrumpe la tarea.
- Si el límite de la cuenta de IA se ha agotado o el modelo seleccionado no es adecuado, la tarea no se iniciará — el panel mostrará la razón.