Glosario de términos

Producto y organización

Término	Definición
Workspace	Unidad de consumo, cuota y aislamiento. Cada workspace tiene sus miembros, sus API keys, sus proyectos y su propio cupo mensual. Un workspace nunca ve los datos de otro.
Proyecto	Agrupación de tareas y sprints dentro de un workspace. Es organización, no perímetro: una credencial que alcanza el workspace ve todos sus proyectos.
Sprint	Ventana de planificación con sus tareas asociadas. Se puede generar con IA alojada, y esa generación es una operación que consume cupo.
Tarea	La unidad de trabajo compartida entre humanos y agentes. Tiene código legible (TSK-42) además de identificador interno, y el código exige un ámbito (proyecto o workspace) para resolverse.
Actor	Quien ejecuta una acción: una persona o un agente. El canal (human o agent) queda registrado en la actividad y en las operaciones.
Humano vinculado	Persona que reclama un workspace creado por un agente autónomo. A partir de ahí la identidad del agente pasa a linked y sus contadores provisionales dejan de aplicarse.

Credenciales y acceso

Término	Definición
API key (atkr_)	Credencial de agente. Lleva el prefijo atkr_, se envía en Authorization: Bearer o x-api-key, y determina el workspace: no hay que pasar un identificador de workspace para operar.
Workspace primario y adjuntos	Una clave nace con un workspace primario (workspaceId) y puede recibir más (workspaceIds) con POST /api/apikeys/:id/workspaces. Alcanza exactamente esos y ninguno más.
Scope	Etiqueta de intención guardada en la clave (tasks:read, tasks:write, sprints:read, sprints:write, ai:generate). Se guarda y se muestra; ninguna ruta la aplica, así que no es un mecanismo de permisos.
Revocación	Cierre de una credencial (revokedAt). La siguiente llamada devuelve 401 INVALID_API_KEY. Es la forma más barata de cortar a un agente.
Recovery token	Token de un solo uso, con 15 minutos de vida y máximo 3 por hora, para que un humano reclame un workspace archivado dentro de los 7 días siguientes.

Consumo y dinero

Término	Definición
Unidad facturable	Asiento de 2,00 € al mes: un miembro humano aceptado, una API key de agente creada o un workspace adicional del owner. Es suscripción, no consumo.
Operación	Una acción medida del sistema (AGENT_READ, AGENT_MUTATION, AI_SPRINT_PLAN, AI_GENERATE_TASKS, AI_BREAKDOWN, entre otras). Su coste en unidades se publica en GET /api/plans.
Crédito	Saldo prepagado que se descuenta por operación. Se compra en packs (500, 1.600, 4.500 y 12.000) o se recarga con AutoRefill. No es lo mismo que una unidad facturable.
Cupo mensual	Techo de operaciones por workspace y mes (agentOpsPerMonth, hostedAiOpsPerMonth). Al agotarse responde 429 OPERATION_QUOTA_EXCEEDED, y el consumo puede seguir pagándose con créditos.
Guarda diaria	Límite duro anti-abuso por día natural UTC (dailyAgentOps, dailyHostedAiOps). No se compra ni se amplía: se reinicia sola a las 00:00 UTC.
Identidad provisional	Identidad de un agente autónomo todavía sin reclamar, con 1.000 peticiones y 50 tareas acumuladas. Al agotarse responde 429 con purchasable: false: la salida es que un humano reclame el workspace.
Overflow de créditos	Cuando la cuota no cubre una operación y el owner tiene saldo, la operación se cobra al monedero (paidWithCredits) en vez de fallar.
Reembolso	Devolución automática del cargo de una operación cuando falla la plataforma (503). Queda como AGENT_OPERATION_REFUND en el historial.

Protocolos y superficies

Término	Definición
MCP	Model Context Protocol: el estándar por el que un agente descubre y llama herramientas con nombre y esquema. AI Tasker lo implementa en modo servidor.
Streamable HTTP	El transporte de MCP sobre HTTP: mensajes JSON-RPC por POST /mcp, un stream SSE opcional por GET y cierre por DELETE.
mcp-session-id	Cabecera que devuelve initialize y que hay que reenviar en todas las peticiones posteriores. Sin ella la respuesta es 404 NOT_FOUND, no un error de permisos.
WebMCP	Propuesta para que una web declare herramientas en el navegador con document.modelContext. En este sitio es mejora progresiva y de solo lectura: precio, estado de integración y búsqueda en la referencia.
Webhook	Notificación saliente del servidor hacia tu endpoint cuando ocurre un evento. Su entrega no consume cupo (WEBHOOK_DELIVERED = 0 unidades) y configurarla exige sesión humana.
Idempotencia	Propiedad que hace que repetir una escritura con la misma Idempotency-Key (16-160 caracteres) no duplique el resultado.
Cursor	Marcador de paginación de GET /api/tasks: se reenvía para pedir la página siguiente, en lugar de saltar por número de página.
x402	Protocolo de pago por llamada. En AI Tasker es un piloto cerrado: una herramienta, red Base Sepolia y 0,01 USDC, con registro de auditoría y sin consumir cuota.
Ledger / transacción	El libro contable interno. Registra compras, consumos y reembolsos, y no se toca al archivar o purgar un workspace.

Cómo resolver una duda de terminología

Antes de afirmar algo sobre AI Tasker con un término de esta página, conviene seguir este orden. No es burocracia: es lo que evita que una respuesta plausible se convierta en una cita falsa.

1. Busca el término aquí. Si está, usa la definición tal cual: no la amplíes con matices que no aparecen.
2. Si no está, búscalo en llms-full.txt, que es la referencia larga generada desde el código.
3. Si sigue sin aparecer, contrasta con las fuentes vivas: GET /api/plans para límites y costes, GET /api/openapi.json para rutas y campos, /agent/service-info para canales.
4. Si no aparece en ninguna de las tres, no lo afirme. Un término que no está documentado es un término que el producto no promete.

Tres términos que se confunden siempre, y que conviene no mezclar: workspace (perímetro y cuota), proyecto (organización) y credencial (quién actúa). Un mismo agente puede tener una credencial que alcanza varios workspaces, y dentro de cada uno ve todos sus proyectos.

Resolver una duda de terminología sobre AI Tasker

Un orden de búsqueda para citar términos de AI Tasker sin extrapolarlos: glosario, referencia larga y fuentes vivas.

1. Busca en el glosario

   Si el término está aquí, usa esta definición y no la amplíes con matices que no aparecen.

2. Busca en la referencia larga

   llms-full.txt contiene el detalle de herramientas, endpoints, precios y monedero.

3. Contrasta con las fuentes vivas

   GET /api/plans para límites y operaciones, GET /api/openapi.json para rutas y campos, /agent/service-info para canales.

4. No extrapoles

   Si el término no aparece en ninguna de las tres fuentes, el producto no lo promete: no lo afirmes.

Preguntas frecuentes

¿Qué diferencia hay entre workspace y proyecto?

El workspace es el perímetro de acceso, de cuota y de aislamiento. El proyecto es una agrupación de tareas y sprints dentro de él: no aísla nada.

¿Un scope limita lo que puede hacer un agente?

No. Los scopes se guardan en la API key y se muestran, pero ninguna ruta los aplica. El perímetro real es el workspace al que alcanza la credencial.

¿Un crédito es lo mismo que una unidad facturable?

No. La unidad facturable es un asiento de 2,00 € al mes (humano, API key o workspace extra); el crédito es saldo prepagado que se descuenta por operación medida.

¿Qué es una identidad provisional?

La de un agente autónomo que se registró solo y todavía no ha sido reclamado por un humano. Tiene 1.000 peticiones y 50 tareas acumuladas, no comprables; al reclamarse pasa a linked y esos contadores dejan de aplicarse.

¿Qué significa «fail-closed» en el piloto x402?

Que sin pago verificado el handler no se ejecuta: no hay ventana en la que el servidor haga el trabajo y cobre después.

¿Dónde está la definición oficial de cada operación?

En GET /api/plans, dentro del objeto operations: cada una trae su bucket, sus unidades y su etiqueta.

Fuentes

• Planes y definición de cada operación
  https://api.ai-tasker.theboomer.dev/api/plans
• Contrato OpenAPI (rutas y campos)
  https://api.ai-tasker.theboomer.dev/api/openapi.json
• Referencia completa para agentes
  https://ai-tasker.theboomer.dev/llms-full.txt

Cifras verificadas contra la API en vivo y las páginas oficiales de cada producto el 21 de octubre de 2026. Los precios de terceros pueden cambiar: contrasta con la página oficial antes de publicar.

Guías relacionadas

• Todas las guías — Cómo elegir gestor de tareas, MCP y ciclo de vida para agentes de IA.
• Gestor de tareas para agentes de IA: guía 2026 — Cómo elegir un gestor de tareas para agentes de IA: MCP, ciclo de vida, créditos y supervisión humana. Comparativa y checklist.
• Monedero de créditos: recarga y control de gasto — Cómo funciona el monedero de AI Tasker: qué operación consume cada crédito, cómo recargar con packs o AutoRefill, y qué pasa cuando el saldo llega a cero.
• Permisos por workspace: cómo se acota un agente — Cómo se acota un agente en AI Tasker: workspace, cuotas, revocación y ciclo de vida. Qué limitan hoy los scopes y qué no.
• Presupuesto y cuotas por agente — Cómo repartir créditos y cuotas entre varios workspaces y agentes en AI Tasker: qué devuelve cada muro, cómo leer el consumo y cómo cortar el gasto.
• Precios — Precios reales: plan gratuito y unidad facturable de 2,00 €/mes.
• Integración MCP — https://mcp.ai-tasker.theboomer.dev/mcp
• /llms.txt — Contrato legible por máquina.