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

Listas de compras y pendientes

La libretita digital sin libretita. Le dictas “agrega leche y pan al súper” y queda. En el pasillo del mercado pides “muéstrame el súper” y la ves. Con varios items en un solo mensaje, sin formularios, sin otra app.


§ 2.4.1 Qué entiende #

Las listas de Arkos son colecciones nombradas de items con dos estados — pendiente o completado. Cada item es texto libre. No hay fechas, prioridades ni asignados; si necesitas eso es un recordatorio o un evento de Calendar.

Múltiples listas

Puedes tener todas las listas que quieras, no hay una sola lista global. La convención es que el nombre describa el contexto: súper, compras, pendientes, casa, regalos navidad, pelis por ver. El agente busca por nombre exacto o muy parecido — si no existe, la crea sobre la marcha.

§ 2.4.2 Crear y agregar items #

No necesitas crear la lista antes — el primer “agrega leche al súper” crea la lista súper y mete leche de una. Si ya existe, simplemente añade. Internamente la tool agregarItemsALista deduplica: si ya tenías leche, no te queda dos veces.

Varios items en un mensaje

El caso típico: vas dictando lo que se te ocurre. “agrega leche, pan, jamón y aguacate al súper” en una sola frase crea los cuatro items de un golpe. El agente parsea la lista natural — comas, “y”, saltos de línea, viñetas — y los pasa todos a la tool en un array.

§ 2.4.3 Marcar y eliminar items #

Cuando vas comprando: “ya compré leche”, “tacha el pan del súper”, “marca aguacate como hecho”. La tool marcarItemLista hace match parcial e insensible a mayúsculas — no necesitas escribir el item idéntico.

Para borrarlo definitivamente (porque te equivocaste, no porque ya lo compraste): “quita papel higiénico del súper”, “elimina aguacate de la lista”. Esto usa eliminarItemLista y deja la lista sin esa entrada.

§ 2.4.4 Consultar listas #

“muéstrame el súper”, “¿qué tengo en pendientes?” abre una lista específica con sus items pendientes y completados. “lista todas mis listas” sin nombre devuelve todas con el conteo de pendientes / total. El agente lo formatea con monoespacio para que se lea bien en WhatsApp.

§ 2.4.5 Flujo completo: ir al mercado #

El caso de uso por excelencia. Antes de salir armas la lista; en el pasillo la consultas y vas marcando lo que ya está en el carrito. Termina la compra, queda el registro.