Asistente de IA

El asistente de IA es una superficie de chat que conoce tu vault. Puede responder preguntas sobre tus notas, resumir un documento largo, encontrar un pasaje que recuerdas a medias, redactar una presentación desde un tablero, programar una semana de tareas, o proponer ediciones a una nota — y cada respuesta cita las notas de las que vino, y cada edición viene con una vista previa que apruebas antes de que se guarde algo.

La filosofía de diseño es proponer, no imponer. El asistente es un colaborador, no un piloto automático. Sugiere; tú decides. Todo lo que hace es reversible con un clic.

Esta página cubre qué es el asistente, cómo funciona, cómo configurarlo y el sistema de agentes y habilidades que te permite personalizarlo.

Qué puede hacer el asistente

Una lista corta de cosas que la gente usa con el asistente:

• Responder preguntas sobre tu vault. “¿Qué decidí sobre el precio de lanzamiento?” El asistente busca en las notas, encuentra los pasajes relevantes y responde con citas — enlaces a las notas y las secciones específicas de las que vinieron.
• Resumir una nota larga. “Resume mi lectura del ensayo de la orilla.” El asistente lee la nota, produce un resumen ajustado y apunta a la fuente.
• Encontrar cosas que recuerdas a medias. “¿Dónde está la nota sobre la llamada con el cliente el mes pasado?” El asistente busca semánticamente, no solo por palabra clave, así que puede encontrar la nota aunque no recuerdes las palabras exactas.
• Redactar una presentación desde un tablero. “Haz una presentación de 10 diapositivas desde este tablero.” Consulta la sección de agentes más abajo.
• Programar tareas. “Programa las tareas de lanzamiento para la próxima semana.” El asistente propone un cronograma, tú revisas y aceptas. Consulta Calendario para detalles.
• Proponer ediciones a una nota. “Ajusta el párrafo de apertura del ensayo de la orilla.” El asistente muestra una vista previa de la edición propuesta, lado a lado con el texto actual. Aceptas o rechazas.
• Crear una nota nueva desde un prompt. “Empieza una nota sobre lo que aprendimos de la retrospectiva de lanzamiento.” El asistente redacta la nota y propone un título. Aceptas y editas.
• Encontrar conexiones. “¿Qué notas están relacionadas con el trabajo del sistema de diseño?” El asistente recorre el grafo de wikilinks y la estructura de etiquetas, y propone enlaces que podrías añadir.

Algunas cosas que el asistente explícitamente no hace:

• No edita tu vault sin vista previa. Cada cambio viene con una vista previa. Nada se fusiona hasta que aceptas.
• No habla con la web abierta por defecto. Las respuestas citan tus notas, no Wikipedia o Reddit. El asistente está anclado en tu vault.
• No comparte tus datos con nadie a menos que se lo pidas. El proveedor que elijas ve solo el contenido que pones activamente frente al asistente. Consulta la sección de privacidad más abajo.

Cómo funciona

El asistente es un panel de chat que vive en el sidebar. Escribes una pregunta o solicitud, y responde en una conversación. Por detrás:

1. Tu mensaje va al asistente. El asistente usa una mezcla de tu nota activa, el contexto enlazado que proporcionas y los resultados de búsqueda del sistema RAG para encontrar material relevante.
2. El asistente redacta una respuesta. La respuesta puede incluir texto, citas y acciones propuestas (editar una nota, crear una tarea, construir una presentación, etc.).
3. La respuesta aparece en el chat. Las citas son clicables — saltan a la nota de la que vinieron. Las acciones propuestas vienen con una vista previa.
4. Aceptas, rechazas o refinas. Cada acción tiene una vista previa. Aceptar aplica el cambio; rechazar lo descarta. Refinar te permite pedir una versión distinta.
5. La conversación se conserva. El chat es una cosa real en tu vault. Puedes desplazarte hacia atrás, copiar respuestas útiles y referenciar conversaciones pasadas.

El asistente está anclado en tu vault. El comportamiento predeterminado es responder con citas a tus notas, no la web abierta. Esta es una elección de diseño deliberada — el asistente está pensado para ser un compañero de pensamiento para tu trabajo, no un chatbot genérico.

Ajustes de proveedor: trae el tuyo

El asistente funciona con una gama de proveedores de IA. Traes tu propia clave API, instalas el plugin Local AI Models, o apuntas Zettly a un servidor que ejecutas tú mismo. Nada se envía a un proveedor que no hayas configurado.

Los proveedores soportados incluyen:

• OpenAI (GPT-4, GPT-4o y otros modelos). Proporcionas una clave API de OpenAI.
• Anthropic (Claude). Proporcionas una clave API de Anthropic.
• Google Gemini. Proporcionas una clave API de Google AI.
• Local AI Models — modelos GGUF en el dispositivo vía el plugin zettly-local-models. Instálalo desde el marketplace de Plugins; no viene incluido con la app. Corre enteramente en tu máquina; nada sale. La descarga del modelo y el asistente de ajuste de hardware viven en la sección de ajustes Local models del plugin.
• Ollama / LM Studio / servidor llama.cpp — apunta Zettly a cualquier servidor HTTP compatible con OpenAI que ejecutes tú mismo. Sigue siendo local, pero gestionas el servidor y los modelos fuera de Zettly.

Algunas notas prácticas:

• La elección de proveedor es por vault. Puedes tener un vault usando un modelo local y otro usando un proveedor en la nube. La elección está en los ajustes del vault.
• Las claves API se almacenan localmente. Las claves se guardan en tu vault, cifradas en reposo. Nunca salen de tu máquina excepto para autenticarse con el proveedor.
• El modelo puede cambiarse por tarea. Algunas tareas (resumen) funcionan bien con modelos rápidos y baratos. Otras (investigación profunda) se benefician de un modelo más capaz. Puedes configurar el predeterminado por tipo de tarea, o anular por conversación.
• Los modelos locales son más lentos pero privados. Los modelos en el dispositivo requieren el plugin Local AI Models. Un modelo local en un portátil será más lento que uno en la nube, pero el asistente del plugin elige un modelo que encaja con tu hardware. El intercambio es privacidad y coste. Para un vault de notas personales, un modelo local suele ser la elección correcta.

Delegación de agentes: especialistas para trabajos grandes

El asistente principal puede delegar en agentes especialistas. Cada agente es una versión afinada del modelo principal, configurada con un rol y conjunto de herramientas específicos.

Los especialistas actuales:

• Constructor de presentaciones. Crea esquemas de diapositivas desde tableros o notas. Pide el objetivo, la audiencia y la longitud deseada, luego propone una secuencia de diapositivas. Cada diapositiva es un borrador — widgets colocados, títulos escritos, formas de apoyo añadidas. Revisas la presentación en el editor de presentaciones.
• Arquitecto de tableros. Compone diseños de tableros. Dado un objetivo (“un tablero de lanzamiento para el release de Q2”), el agente propone un diseño — una nota de proyecto, una lista de tareas, una semana de calendario, una vista de grafo, todo posicionado y conectado. Revisas el tablero propuesto y aceptas.
• Investigación. Recopila y resume con citas. Dada una pregunta, el agente busca en el vault, incorpora los pasajes relevantes y produce un resumen con notas al pie. Útil para preguntas de “¿qué sé sobre X?”.

El triage de tareas y los barridos de calendario siguen en el asistente principal vía skills (task-triage, calendar-sweep). Aún puedes crear especialistas extra desde el asistente de agentes si quieres personas con nombre para esos trabajos.

No necesitas saber que los agentes existen para usarlos. El asistente principal enruta al especialista correcto según lo que pidas. Pero también puedes invocar un especialista directamente desde el menú del asistente.

Habilidades: enseña al agente nuevos trucos

Una habilidad es un paquete de instrucciones en lenguaje natural que le dice al agente cómo manejar una tarea específica. Las habilidades son cómo personalizas el asistente sin escribir código.

Una habilidad es un archivo Markdown en la carpeta skills de tu vault. Tiene un nombre, una descripción e instrucciones. Cuando el asistente cree que una habilidad es relevante, lee las instrucciones y las sigue.

Algunos ejemplos de habilidades útiles:

• Una habilidad de revisión semanal. Instrucciones para que el agente recorra las notas de la semana, resuma los puntos destacados y proponga tareas para la semana que viene.
• Una habilidad de notas de reunión. Instrucciones para que el agente extraiga elementos de acción de una nota de reunión y los archive en el hub de Tareas.
• Una habilidad de feedback de escritura. Instrucciones para que el agente actúe como coach de escritura, con un estilo específico de feedback.

Las habilidades se escriben en inglés plano. No necesitas un desarrollador para crear una. El asistente las lee como instrucciones y las aplica cuando son relevantes.

Puentes MCP: conectar con herramientas externas

Los puentes MCP (Model Context Protocol) son cómo el asistente se conecta con herramientas externas — tu proveedor de calendario, un rastreador de proyectos, un servicio de búsqueda, cualquier cosa que hable MCP. El puente corre localmente, y el asistente puede llamar a las herramientas que expone.

Algunos usos prácticos:

• Un puente de calendario. Lee eventos de un calendario externo, escribe eventos de vuelta. (Algunos usuarios prefieren esto a la importación estándar de Calendario; el puente mantiene la fuente de verdad en el sistema externo.)
• Un puente de búsqueda web. Cuando el predeterminado del asistente es citar solo tus notas, un puente de búsqueda web te permite optar por resultados web para consultas específicas.
• Un puente de rastreador de tareas. Sincroniza tareas con un sistema externo como Linear, Jira o GitHub Issues.

Los puentes se configuran en los ajustes del asistente. Cada puente pide permiso para acceder a los datos que necesita, y puedes revocar ese permiso en cualquier momento. Consulta Plugins para el sistema de plugins más amplio, que incluye puentes.

Una nota sobre el estado alpha

El asistente de IA es la parte de Zettly que más evoluciona activamente. La experiencia central — chat, citas, vistas previas, deshacer — funciona. Los agentes especialistas son funcionales pero toscos. El sistema de puentes MCP es nuevo y no todos los proveedores han sido probados. Espera algunos baches.

Si encuentras un caso donde el asistente hace algo sorprendente, reporta un bug. El equipo presta mucha atención a la experiencia de IA, y el feedback del alpha es lo que da forma a la siguiente iteración.

Consejos y convenciones

Algunas cosas que no son obvias hasta que has usado el asistente un tiempo:

• Cita las citas del asistente. Cuando el asistente dice “en la nota de reunión del 15 de abril”, abre la nota y verifica. El asistente suele acertar, pero eres tú quien necesita confiar en la respuesta.
• Las vistas previas no son sugerencias. La vista previa es lo que se escribirá. Léela como un cambio real. Si la vista previa no es lo que quieres, recházala y pide una versión distinta.
• Usa especialistas para trabajos grandes. Una presentación de 30 diapositivas o una semana completa de programación es trabajo de especialista. Pide al asistente que “use el agente constructor de presentaciones” o simplemente describe lo que quieres — el asistente enrutará.
• Las habilidades son la forma de personalizar. Si te encuentras escribiendo la misma instrucción dos veces, conviértela en una habilidad.

Consulta Memoria y RAG para cómo el asistente fundamenta sus respuestas, y Plugins para el sistema de extensiones más amplio.