Note / Docs
live v1.0.0 es-MX last update 2026.06.17 build #0247
§ 1.3 Tutorial · 5 min de lectura

Tu primera conversación

Esto es lo que se siente usar Arkos Note los primeros diez minutos. Cinco interacciones cortas que cubren todo lo que la mayoría de la gente termina haciendo a diario: pedir, agendar, guardar, recordar y preguntarle al baúl al día siguiente.


§ 1.3.1 Antes de cada ejemplo #

En todos los ejemplos hablas tú primero (mensaje verde) y Arkos contesta (mensaje gris). Las respuestas son lo que realmente te contesta el bot — tono cálido, frases cortas, negritas en los datos clave y emojis bien medidos. Si tu respuesta sale distinta no es bug; el modelo varía las palabras pero el formato se mantiene.

§ 1.3.2 Saluda y deja que sugiera #

Si solo dices "hola" o le mandas algo que no requiere acción, el bot responde corto y te lanza una sugerencia concreta para engancharte con una de sus capacidades.

§ 1.3.3 Pídele un recordatorio #

Recordatorios simples son el caso de uso más común y no requieren autorización Google. Frases relativas ("mañana", "en una hora", "el viernes") las interpreta en tu zona horaria.

Por qué confirma con negritas

Cuando ejecuta una acción, Arkos te devuelve una sola línea con el dato clave en negrita (fecha, hora, monto, nombre). Es una decisión de diseño: confirmaciones largas son ruido, y los datos en negrita son fáciles de escanear de un vistazo en el chat.

Después de confirmar, suele añadir una sugerencia relacionada — natural, no un menú. Ignórala si no aplica; no la repite si la rechazas.

§ 1.3.4 Agenda una junta en Calendar #

Si en el dashboard ya conectaste Calendar, puedes agendar reuniones con duración. Arkos las crea en tu calendario principal con los detalles que le diste.

Recordatorio vs evento

Hay una distinción importante en cómo decide la herramienta:

  • Recordatorio puntual · cuando es un texto literal a recibir a una hora ("recuérdame X a las Y"). Vive en la base de Arkos, no en tu Google Calendar.
  • Evento de calendar · cuando hay duración (de–a), personas o ubicación. Eso sí entra a Google Calendar y lo ven los invitados.

§ 1.3.5 Manda una foto al baúl #

El baúl es la memoria de largo plazo: imágenes, audios y PDFs que quieres no perder. Arkos los analiza con visión, los describe y los indexa con embeddings para que después puedas buscarlos por significado, no por nombre.

§ 1.3.6 Consulta el baúl al día siguiente #

La parte mágica del baúl no es guardar — es recuperar sin recordar el nombre exacto. La búsqueda es semántica (pgvector + embeddings), así que describes lo que recuerdas y aparece.

§ 1.3.7 WhatsApp y chat web son la misma sesión #

Además de WhatsApp, hay un chat web en https://panel-note.arkosmx.com/chat. No es un bot distinto: es el mismo agente, la misma memoria, la misma cola de recordatorios. Si abres el chat web a media conversación de WhatsApp, ves los últimos mensajes y puedes seguir desde la computadora.

Cómo persiste el sessionId

Cada usuario tiene una sesión activa por canal persistida en PostgreSQL. WhatsApp y chat web comparten clave (wa-user-<id>), así que ambos canales escriben y leen el mismo hilo. Cuando el bot agrega "🤖 escribiendo…" en uno, en el otro también se ve el resultado al refrescar.

§ 1.3.8 Qué probar después #

Con estos cinco ejemplos ya tienes el modelo mental. Si quieres profundizar, sigue por:

  • Conceptos básicos — cómo decide qué tool invocar, qué es multimodal, cómo funciona la sesión.
  • Glosario — definiciones rápidas si te encontraste con algún término técnico (ADK, embedding, pgvector, OAuth…).
  • Capacidades · ve directo a Recordatorios, Calendar, Listas o Baúl según lo que más uses.