Guía del usuario de QuickAgent
QuickAgent es un espacio de trabajo de agentes de IA que funciona primero en local. Convierte un objetivo en un Run duradero, lo limita mediante un Workspace Profile, solicita revisión antes de las acciones sensibles y conserva los resultados verificados en Artifacts.
Primeros pasos
- Abra Ajustes > IA, añada un proveedor y ejecute su prueba de conexión.
- Abra Ajustes > Workspace Profiles. Elija qué proveedor, herramientas, conexiones, raíces de archivos, fuentes de Knowledge y ámbitos de Memory pueden usarse.
- Seleccione Nuevo chat, elija el perfil y confirme el destino del proveedor que se muestra sobre la conversación.
- Describa un resultado deseado. Añada únicamente los archivos, carpetas, elementos multimedia, Knowledge o Memory necesarios para este Run.
- Revise el plan, las aprobaciones, la confirmación Critical y la Data Send Preview cuando aparezcan.
- Siga el trabajo en la Timeline. Abra el resultado final desde Artifacts e inspeccione el registro de auditoría en Historial.
Descripción de la interfaz
| Sección | Para qué sirve |
|---|---|
| Chats | Conversaciones, destino del proveedor, Context Tray, planes, aprobaciones y la Timeline del Run activo. |
| Runs | Todas las tareas planificadas, en ejecución, en pausa, programadas, fallidas o completadas. |
| Approval Inbox | Revisiones de acciones pendientes, Critical y Data Send que requieren su decisión. |
| Artifacts | Archivos, informes, registros, elementos multimedia, tablas y manifiestos de operación verificados creados por los Runs. |
| Automations | Programaciones, monitores, webhooks, eventos de la app y disparadores de Shortcut/App Intent. |
| Skills | Instrucciones reutilizables con entradas tipadas, herramientas permitidas, conexiones requeridas, riesgo y salidas. |
| Connections | Proveedores, perfiles de navegador, raíces de archivos/VFS, SSH, MCP, HTTP/SaaS, puentes domésticos y canales de notificación. |
| Knowledge | Carpetas indexadas, contenido de QuickNote, recortes web, PDF y fuentes de Office. |
| Historial | Decisiones de seguridad, acciones de herramientas, destinos y marcas de tiempo, en formato de solo adición. |
| Ajustes | Apariencia, idioma, IA, herramientas, seguridad, Workspace Profiles, atajos, permisos, Ayuda y Pro. |
Proveedores y Workspace Profiles
QuickAgent puede usar la IA del sistema cuando el sistema operativo expone una capacidad compatible, proveedores locales como Ollama, LM Studio o DeskLLM, endpoints en la red LAN o personalizados compatibles con OpenAI, y proveedores en la nube configurados como Anthropic o Gemini. La disponibilidad se determina mediante una prueba de capacidad en vivo; el nombre de un proveedor por sí solo no significa que esté listo.
Un Workspace Profile es el marco de permisos del Run. Captura el proveedor y el modelo seleccionados, las herramientas permitidas, las conexiones, las raíces de archivos, las fuentes de Knowledge, los ámbitos de Memory, las excepciones de seguridad y el presupuesto. Un cambio de configuración posterior deja obsoleta esa captura y obliga a revisarla.
Runs, aprobaciones y recuperación
Controles del Run
- Pausar solicita una detención cooperativa en un punto de control duradero.
- Reanudar continúa el mismo Run y el trabajo ya completado.
- Detener cancela el trabajo del proveedor y de las herramientas. Un efecto externo detenido o incierto no se comunica como éxito.
- Reintentar solo está disponible cuando QuickAgent puede identificar un límite de reintento seguro.
Niveles de seguridad
| Nivel | Significado |
|---|---|
| Safe | Leer, inspeccionar o transformar dentro del perfil activo. |
| Approve | Revisar una escritura normal o una acción externa. |
| Confirme que | Revisar un cambio de mayor impacto o más difícil de deshacer. |
| Critical | Confirmación reforzada en todos los casos; las reglas nunca lo aprueban automáticamente. |
La aprobación muestra el objetivo exacto, el destino, los argumentos propuestos, el riesgo y el estado de Undo. Si edita un argumento, QuickAgent vuelve a validar y a evaluar el riesgo de la acción editada.
Runs multiagente
Los objetivos complejos pueden usar un planificador, trabajadores especialistas tipados, un revisor y un revisor de seguridad. La Timeline muestra cada traspaso, revisión, reintento, alternativa y límite de respuesta final. Los trabajadores reciben únicamente la intersección de cuatro conjuntos: herramientas de la Skill, herramientas del Workspace Profile, herramientas del rol y herramientas actualmente activas.
Los presupuestos globales y por rol limitan las invocaciones, el tiempo, el coste, los bytes de red y los tokens. Cuando se alcanza un presupuesto, QuickAgent hace una pausa. Muestra los límites actuales y los propuestos, y solo los aumenta tras una revisión explícita. El presupuesto aprobado y el historial de roles completados sobreviven a un reinicio.
Contexto, Knowledge y AI Memory
Context Tray
Añada archivos, carpetas, imágenes, fotogramas de vídeo, audio, notas de voz, contenido de QuickNote, Knowledge o Workspace Memory. QuickAgent extrae o resume el contenido compatible y muestra si un adjunto se enviará directamente a un proveedor.
Knowledge
Las fuentes de Knowledge se indexan de forma independiente del chat. Un Run solo puede buscar en las fuentes permitidas por su Workspace Profile, y las citas conservan la identidad de su fuente.
Memory
Memory es deliberada, no un historial de chat automático. Los ámbitos User, Workspace, Project y Tool/Connection son independientes. Cada solicitud de creación, edición o eliminación requiere una aprobación nueva, y la previsualización de la aprobación muestra el ámbito y el valor exacto propuesto.
Herramientas y conexiones
El catálogo activo abarca operaciones de archivos y VFS; Office, PDF y datos estructurados; multimedia y OCR; uso del navegador y del ordenador; comandos de desarrollo; SSH; MCP; HTTP y SaaS; puentes domóticos; notificaciones; programaciones; monitores; y control de automatizaciones. Los servidores MCP conectados pueden añadir herramientas dinámicas tras la validación del esquema y una nueva evaluación de riesgo por parte de QuickAgent.
Ajustes > Herramientas muestra por qué una herramienta está lista o desactivada. Los motivos habituales son una conexión ausente, un permiso del sistema operativo, una plataforma no compatible, una restricción del Workspace Profile, un endpoint sin probar o una capacidad del proveedor no disponible.
Automations
Las automatizaciones pueden iniciarse a partir de disparadores de tiempo, archivo o carpeta, web, webhook, correo, calendario, red, host, dispositivo, sensor, ubicación, evento de la app, Shortcut/App Intent, comando o activación manual, cuando la plataforma los admite. Un disparador crea un Run normal; no elude el Workspace Profile ni las comprobaciones de aprobación, Critical o Data Send.
- La monitorización en escritorio continúa únicamente mientras el proceso de la app está en ejecución.
- Las plataformas móviles recuperan el trabajo atrasado cuando la app vuelve a primer plano.
- Use Shortcut/App Intent o un relé de eventos de confianza cuando se requiera la entrega por parte del sistema operativo.
- Los eventos en cola, la pausa, la cancelación y la eliminación siguen siendo explícitos, de modo que ningún evento se descarta en silencio.
Skills y Skill Packs
Una Skill almacena una indicación orientada al resultado, variables tipadas, la recomendación de proveedor, las herramientas permitidas, las conexiones y capacidades requeridas, el riesgo máximo y los Artifacts previstos. Antes de usarla, QuickAgent muestra las entradas y los permisos efectivos; la previsualización no concede permiso por sí misma.
Siete Packs integrados ofrecen Skills reales para Office, programación, domótica, investigación, automatización del navegador, gestión personal y respuesta a incidentes. Puede instalar, actualizar, desinstalar, personalizar, duplicar, importar y exportar Skills. El JSON importado recibe una previsualización de confianza, editor, firma, permisos, riesgo, plataforma y conflictos. «Conservar ambos» crea un derivado local sin firmar en lugar de heredar la confianza de otro editor.
Artifacts, historial y Undo
Los Artifacts conservan los bytes de salida, los metadatos, las versiones, la procedencia, el Run de origen y los manifiestos de operación. Según las capacidades de la plataforma, puede abrirlos, compartirlos, exportarlos o mostrarlos en el sistema de archivos. Las operaciones aptas ofrecen un Undo revisado; el trabajo destructivo o incierto nunca se repite automáticamente.
El historial es de solo adición. Fíltrelo por Safe, Approve, Confirm o Critical, y exporte la auditoría cuando necesite un registro externo.
Ajustes
- General: apariencia, idioma, Workspace Profiles, atajos, Ayuda y permisos.
- IA: proveedores, endpoints, modelos, credenciales y pruebas en vivo.
- Herramientas: preparación del catálogo, compatibilidad con la plataforma y motivos de configuración.
- Seguridad: reglas de aprobación, comportamiento de Data Send, autenticación del dispositivo y política de Memory por ámbitos.
- Avanzado: recuperación y diagnósticos pensados para la resolución de problemas.
Atajos de teclado
En macOS, la app asigna los atajos que muestra con Ctrl a la tecla Command de la plataforma cuando corresponde. La página de atajos de la app es la referencia válida y permite personalizarlos.
| Atajo | Acción |
|---|---|
| Ctrl + N | Nuevo chat |
| Ctrl + L | Enfocar el redactor |
| Ctrl + Shift + Space | Pausar o reanudar el Run activo |
| Ctrl + . | Detener el Run activo |
| Ctrl + 1 … 9 | Abrir Chats a través del historial |
| Ctrl + , | Abrir Ajustes |
| F1 | Abrir Ayuda & privacidad |
| Esc | Cerrar un cuadro de diálogo o cancelar la interacción no destructiva en curso |
Notas por plataforma
| Plataforma | Límites importantes |
|---|---|
| macOS | Sandbox activo en Debug y Release. El acceso a archivos usa raíces seleccionadas y marcadores con ámbito de seguridad. La grabación de pantalla y la accesibilidad son permisos del sistema independientes. Las integraciones con procesos locales y Shortcut siguen sujetas a pruebas de capacidad. |
| Windows | Las funciones de archivos, Office/PDF/datos, navegador, desarrollo, acceso remoto y control del escritorio dependen del entorno de ejecución instalado y de los permisos. Las integraciones exclusivas de Apple no están disponibles y se indica el motivo. |
| iPhone / iPad | Los archivos usan el selector del sistema. La cámara, el micrófono, el reconocimiento de voz, las fotos, la red local y las notificaciones se solicitan en contexto. El trabajo en segundo plano no está garantizado; use Shortcuts/App Intents o la recuperación en primer plano. |
| Android | Los archivos y las carpetas usan el Storage Access Framework. El trabajo en segundo plano sigue las restricciones de Android. El control de entrada basado en accesibilidad nunca se considera concedido por el mero hecho de declarar un servicio. |
| Web | Usa almacenamiento limitado a la sesión para las funciones que requieren persistencia nativa y desactiva claramente las capacidades de dispositivo, raíz de archivos, procesos locales y segundo plano no compatibles. |
Consejos & trucos
Resolución de problemas
| Problema | Qué comprobar |
|---|---|
| El proveedor no puede ejecutarse | Abra Ajustes > IA. Compruebe la configuración, la autenticación, las capacidades del modelo, la accesibilidad del endpoint, el tiempo de espera y los detalles de límite de tasa, y ejecute después la prueba de conexión. |
| Una herramienta está desactivada | Abra Ajustes > Herramientas y lea el motivo en vivo. Revise la plataforma actual, el permiso, la prueba de conexión, el Workspace Profile y la raíz seleccionada. |
| Un Run parece bloqueado | Abra Runs y la Timeline. Puede estar en pausa, esperando una entrada, una aprobación, una confirmación Critical, una revisión de Data Send o una revisión de presupuesto. Detener sigue disponible. |
| Ha cambiado un permiso | Abra Ayuda > Resumen o Ajustes y, a continuación, abra los ajustes del sistema. Vuelva a probar la conexión o la herramienta afectada al regresar. |
| Una acción externa es incierta | Revise el sistema de destino. Mantenga el Run en pausa o deténgalo salvo que haya verificado que reintentar es adecuado. |
| Una automatización no se activó en segundo plano | Los sistemas operativos móviles no garantizan un sondeo arbitrario. Vuelva a primer plano para la recuperación o configure un Shortcut/App Intent o una fuente de eventos de confianza. |
| Un Artifact no se abre ni se exporta | Compruebe si sus bytes siguen disponibles, si la plataforma admite la acción y si el permiso del destino elegido sigue siendo válido. |
Privacidad, permisos y licencias
QuickAgent guarda localmente las conversaciones, los Runs, las aprobaciones, los metadatos de Knowledge, las Skills y los ajustes. Las credenciales usan el almacén protegido de la plataforma. El contenido solo sale del dispositivo a través de un proveedor o servicio conectado que usted configure, y los envíos externos incluyen una previsualización que indica el destino.
Los permisos se solicitan en contexto: archivos y carpetas, fotos, cámara, micrófono, reconocimiento de voz, red local, notificaciones, grabación de pantalla y control de accesibilidad y de entrada son independientes. Retirar un permiso deja la capacidad afectada como no disponible, en lugar de producir un falso éxito.
Abra Ajustes > Ayuda & privacidad para consultar la tabla de capacidades de la plataforma actual y Licencias de código abierto para ver los avisos de paquetes y componentes nativos incluidos.