base · xam-dev-ux · Mar 4, 2026
diff --git a/docs/es/ai-agents/core-concepts/agent-apps.mdx b/docs/es/ai-agents/core-concepts/agent-apps.mdx
@@ -0,0 +1,75 @@
+---
+title: "Aplicaciones de Agentes"
+description: "Construye servicios diseñados para agentes y haz que tu aplicación sea descubrible"
+---
+
+import { GithubRepoCard } from "/snippets/GithubRepoCard.mdx";
+
+Una aplicación de agentes es un servicio construido con agentes de IA como el usuario principal. En lugar de renderizar una interfaz visual para que los humanos hagan clic, una aplicación de agentes expone endpoints estructurados que los agentes pueden descubrir, entender y llamar programáticamente.
+
+<iframe
+  className="w-full aspect-video rounded-xl"
+  src="https://www.youtube.com/embed/-y0ZJ-0z7Ow?si=YtmXlwM_3m8Gm0WE"
+  title="Building agent apps on Base"
+  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
+  allowFullScreen
+></iframe>
+
+## Cómo los agentes descubren tu aplicación
+
+Los agentes encuentran tu servicio a través de un archivo `SKILL.md` alojado en una ruta de URL bien conocida: `/.well-known/SKILL.md`. Si has trabajado con desarrollo web, este patrón puede ser familiar:
+
+- Apple usa `/.well-known/apple-app-site-association` para enlaces universales
+- Las autoridades de certificados SSL usan `/.well-known/acme-challenge/` para verificar la propiedad del dominio
+- OAuth usa `/.well-known/openid-configuration` para descubrimiento
+
+La convención `/.well-known/` es una forma estándar de alojar metadatos en una ubicación predecible. Para aplicaciones de agentes, tu archivo `SKILL.md` vive ahí para que cualquier agente pueda encontrarlo verificando `tudominio.com/.well-known/SKILL.md`.
+
+### Qué va en un SKILL.md
+
+Tu archivo `SKILL.md` describe qué hace tu aplicación, qué endpoints están disponibles y cómo usarlos. Aquí hay una plantilla conceptual:
+
+```markdown Title "SKILL.md template"
+# Nombre de Tu Aplicación
+
+## Descripción
+Qué hace tu aplicación, en lenguaje simple.
+
+## Endpoints
+
+### POST /api/action-name
+- **Descripción:** Qué hace este endpoint
+- **Entradas:** Qué parámetros espera
+- **Salida:** Qué devuelve
+- **Pago:** Si requiere pago x402 y el costo
+
+## Autenticación
+Cómo los agentes deben autenticarse (por ejemplo, SIWA, clave de API, x402).
+```
+
+Cuando un agente lee tu `SKILL.md`, entiende qué ofrece tu servicio y cómo interactuar con él, sin humanos en el medio.
+
+## Diseñando para usuarios agentes
+
+Los agentes no son humanos. No navegan, adivinan o interpretan señales visuales. Al construir una aplicación de agentes, sigue estas pautas:
+
+- **Documenta efectos secundarios**: si un endpoint transfiere fondos, modifica estado o desencadena acciones externas, dilo explícitamente en tu `SKILL.md`
+- **Devuelve JSON estructurado**: los agentes analizan JSON, no HTML. Cada endpoint debe devolver respuestas JSON bien estructuradas con nombres de campo consistentes
+- **Soporta x402 para acceso de pago**: si tu servicio cuesta dinero, implementa el [protocolo x402](/ai-agents/core-concepts/payments-and-transactions) para que los agentes puedan pagar por solicitud sin pre-registro
+- **Usa respuestas de error claras**: devuelve mensajes de error descriptivos con códigos de estado HTTP apropiados para que los agentes puedan manejar fallos elegantemente
+
+## Haciendo tu aplicación descubrible
+
+Aloja tu `SKILL.md` en `/.well-known/SKILL.md` y registra tu aplicación en el [registry ERC-8004](/ai-agents/core-concepts/identity-verification-auth). El mismo registry usado para identidad de agentes se usa para descubrimiento de aplicaciones. Una vez registrado, los agentes pueden consultar el registry, encontrar tu servicio y leer tu `SKILL.md` para entender cómo interactuar con él.
+
+<Warning>
+El Agent App Framework es experimental. Las APIs y convenciones pueden cambiar a medida que el estándar evoluciona.
+</Warning>
+
+<GithubRepoCard title="Agent App Framework" githubUrl="https://github.com/base/agent-apps-experimental" />
+
+## Continúa explorando
+
+<Card title="Volver al resumen" icon="arrow-left" href="/ai-agents/index">
+  Regresa al resumen de agentes de IA para un resumen de todos los componentes.
+</Card>
diff --git a/docs/es/ai-agents/core-concepts/agent-frameworks.mdx b/docs/es/ai-agents/core-concepts/agent-frameworks.mdx
@@ -0,0 +1,61 @@
+---
+title: "Frameworks"
+description: "Elige el framework adecuado para construir y ejecutar agentes de IA en Base"
+---
+
+Tu primera decisión al construir un agente de IA en Base es elegir un framework. Esto determina cómo escribes la lógica de tu agente, dónde se ejecuta y cuánta infraestructura gestionas tú mismo.
+
+<iframe
+  className="w-full aspect-video rounded-xl"
+  src="https://www.youtube.com/embed/b5Wx2NAeY2E?si=r1FumIsbGt6nAt29"
+  title="Building agents on Base"
+  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
+  allowFullScreen
+></iframe>
+
+## Comparando tus opciones
+
+| | BANKR | OpenClaw | Agent SDK |
+|---|---|---|---|
+| **Qué es** | Un API de agente gestionado, más plugins de skill y wallet para OpenClaw | Un asistente de IA personal de código abierto que se ejecuta en múltiples canales (Discord, Telegram, web) | Un conjunto de herramientas para desarrolladores para construir agentes personalizados con control total sobre comportamiento e integraciones |
+| **Lenguaje** | Cualquiera (REST API) para Agent API; TypeScript para plugins de OpenClaw | TypeScript | TypeScript / Python |
+| **Alojamiento** | Agent API es gestionado por BANKR; los plugins de OpenClaw se ejecutan en tu agente auto-hospedado | Auto-hospedado | Auto-hospedado |
+| **Mejor para** | Agent API para agregar capacidades onchain sin gestionar infraestructura; plugins de OpenClaw para agregar skills onchain a un agente auto-hospedado | Ejecutar un asistente multicanal con skills preconstruidos y soporte de plugins | Agentes de producción donde necesitas control total sobre lógica, integraciones y despliegue |
+
+## BANKR
+
+BANKR ofrece dos formas de trabajar con agentes en Base. El **BANKR Agent API** es un agente hospedado con el que interactúas a través de un REST API: envías prompts y recibes resultados, incluyendo la capacidad de ejecutar intercambios y verificar balances, sin construir o desplegar tu propio agente. Esta es la forma más rápida de agregar capacidades de agente onchain a una aplicación existente.
+
+BANKR también proporciona **skills y plugins de wallet para OpenClaw**. Si estás construyendo con OpenClaw, puedes instalar los paquetes de skill de BANKR para dar a tu agente auto-hospedado capacidades de wallet, intercambios de tokens y otras acciones onchain sin usar el API gestionado.
+
+Usa el BANKR Agent API cuando quieras capacidades de agente onchain sin gestionar infraestructura. Usa los plugins de OpenClaw de BANKR cuando quieras los skills onchain de BANKR dentro de tu propio agente auto-hospedado.
+
+[Comienza con BANKR Agent API →](https://docs.bankr.bot/getting-started/quick-start)
+
+[Explora los skills de BANKR para OpenClaw →](https://github.com/BankrBot/openclaw-skills)
+
+## OpenClaw
+
+OpenClaw es un asistente de IA de código abierto que se conecta a múltiples plataformas de mensajería de forma predeterminada. Viene con un sistema de plugins para agregar skills (acciones preconstruidas que tu agente puede realizar) y maneja la infraestructura para recibir mensajes, procesarlos y responder a través de canales.
+
+Usa OpenClaw cuando quieras ejecutar un agente conversacional a través de Discord, Telegram o web y extenderlo con plugins construidos por la comunidad.
+
+[Comienza con OpenClaw →](https://docs.openclaw.ai/start/getting-started)
+
+## Agent SDK
+
+El Agent SDK de Coinbase te da los bloques de construcción para crear agentes que pueden interactuar con <Tooltip tip="Protocolos y aplicaciones basados en blockchain, como exchanges descentralizados o plataformas de préstamos">servicios onchain</Tooltip>. Tú escribes la lógica del agente, defines sus herramientas y lo despliegas en tu propia infraestructura. Esta es la opción más flexible: controlas cada aspecto del comportamiento del agente, desde cómo procesa los prompts hasta qué servicios llama.
+
+Usa Agent SDK cuando estés construyendo un agente de producción y quieras control total sobre su arquitectura.
+
+[Comienza con Agent SDK →](https://docs.cdp.coinbase.com/agent-kit/welcome)
+
+<Tip>
+**Cómo elegir:** Usa el **BANKR Agent API** para llamar a un agente vía API sin construir uno, o agrega **los plugins de skill de BANKR** a un agente OpenClaw para capacidades onchain. Usa **OpenClaw** si necesitas un chatbot multicanal con plugins. Usa **Agent SDK** si quieres control total sobre lógica, integraciones y despliegue.
+</Tip>
+
+## Siguiente paso
+
+<Card title="Wallets" icon="arrow-right" href="/ai-agents/core-concepts/wallets">
+  Dale a tu agente la capacidad de mantener fondos y realizar pagos.
+</Card>
diff --git a/docs/es/ai-agents/core-concepts/identity-verification-auth.mdx b/docs/es/ai-agents/core-concepts/identity-verification-auth.mdx
@@ -0,0 +1,84 @@
+---
+title: "Identidad, Verificación y Autenticación"
+description: "Haz que tu agente sea descubrible y verificable para que otros agentes y servicios puedan confiar en él"
+---
+
+Cuando tu agente llama a un servicio, ¿cómo sabe ese servicio que es realmente tu agente y no un impostor? Cuando tu agente recibe una respuesta, ¿cómo sabe que la respuesta provino de un servicio legítimo? La identidad, verificación y autenticación resuelven estos problemas.
+
+<iframe
+  className="w-full aspect-video rounded-xl"
+  src="https://www.youtube.com/embed/l387PXGnrgU?si=EM4IKT14ajFoYkNP"
+  title="Agent identity, verification, and auth"
+  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
+  allowFullScreen
+></iframe>
+
+## Por qué la identidad importa
+
+En un mundo donde los agentes interactúan entre sí y con servicios de forma autónoma, la confianza es la base. Sin identidad:
+
+- Un servicio no puede verificar que una solicitud provino de un agente autorizado
+- Tu agente no puede verificar que una respuesta provino del servicio real (no un impostor malicioso)
+- Otros agentes no pueden descubrir qué hace tu agente o cómo interactuar con él
+
+Los estándares de identidad en Base resuelven los tres problemas: permiten que tu agente se registre en un directorio público, pruebe su identidad con cada solicitud y descubra otros agentes y servicios.
+
+## Registry: un directorio público para agentes
+
+Un registry es un directorio público donde los agentes y servicios publican su identidad. Cualquier participante puede consultar el registry para resolver el nombre de un agente a sus metadatos: qué hace, dónde viven sus endpoints y qué clave pública usa para firmar.
+
+En Base, esto se implementa a través del estándar **ERC-8004**. Cuando tu agente se registra, su entrada se almacena onchain, lo que significa que cualquiera puede verificarla sin depender de una autoridad central.
+
+Una entrada de registry típicamente incluye:
+
+- El nombre y descripción de tu agente
+- Los endpoints donde puede ser alcanzado
+- Un <Tooltip tip="Un par de claves criptográficas: la clave pública se comparte abiertamente (como una dirección de retorno) e identifica tu agente, mientras que la clave privada se mantiene secreta (como un sello de firma) y prueba que controlas la identidad">par de claves</Tooltip> que vincula la identidad del agente a sus credenciales criptográficas
+
+[Aprende más sobre Agent Registry (ERC-8004) →](https://www.8004.org/)
+
+## Verificación: probando identidad en runtime
+
+El registro le dice al mundo que tu agente existe. La verificación prueba que es realmente tu agente haciendo cada solicitud. Esto es manejado por el estándar **ERC-8128**.
+
+<Steps>
+  <Step title="Registra tu agente">
+    Tu agente registra su identidad y clave pública en el registry ERC-8004. Este es un paso de configuración único.
+  </Step>
+
+  <Step title="Firma cada solicitud">
+    Cuando tu agente llama a un servicio, firma la solicitud usando su clave privada. Esto crea una firma criptográfica única para esa solicitud específica.
+  </Step>
+
+  <Step title="El servicio verifica la firma">
+    El servicio busca la clave pública de tu agente desde el registry, luego verifica la firma. Si la firma coincide, el servicio sabe que la solicitud provino de tu agente registrado y no de un impostor.
+  </Step>
+</Steps>
+
+Esto funciona en ambas direcciones: tu agente también puede verificar que la respuesta de un servicio es auténtica verificando la firma del servicio contra el registry.
+
+[Aprende más sobre Agent Verification (ERC-8128) →](https://erc8128.slice.so/concepts/overview)
+
+## Sign In With Agent (SIWA)
+
+SIWA agrupa registry y verificación en un solo SDK, similar a cómo "Sign in with Google" agrupa OAuth y verificación de identidad en una integración. En lugar de conectar ERC-8004 y ERC-8128 por separado, integras SIWA y obtienes ambas capacidades de forma predeterminada.
+
+Con SIWA, tu agente puede:
+
+- **Registrar su identidad** en el directorio onchain
+- **Autenticarse en servicios** probando que es el agente registrado
+- **Firmar cada solicitud** para que los servicios puedan verificar autenticidad
+
+SIWA es la ruta más rápida para dar a tu agente una identidad verificable. Usa ERC-8004 y ERC-8128 directamente solo si necesitas un control más granular sobre el proceso de registro y verificación.
+
+[Aprende más en siwa.id →](https://siwa.id)
+
+<Tip>
+**Comienza con SIWA** para la ruta de integración más simple. Usa ERC-8004 y ERC-8128 directamente si necesitas control detallado sobre cómo tu agente se registra y cómo se realiza la verificación.
+</Tip>
+
+## Siguiente paso
+
+<Card title="Aplicaciones de agentes" icon="arrow-right" href="/ai-agents/core-concepts/agent-apps">
+  Construye servicios diseñados para agentes y haz que tu aplicación sea descubrible.
+</Card>
diff --git a/docs/es/ai-agents/core-concepts/payments-and-transactions.mdx b/docs/es/ai-agents/core-concepts/payments-and-transactions.mdx
@@ -0,0 +1,94 @@
+---
+title: "Pagos y Transacciones"
+description: "Cómo tu agente paga por servicios, recibe pagos y ejecuta acciones onchain"
+---
+
+Tu agente tiene un wallet. Ahora necesita usarlo. Esta página cubre dos conceptos clave: cómo tu agente paga por servicios automáticamente usando el protocolo x402, y cómo los skills definen las acciones que tu agente puede realizar.
+
+<iframe
+  className="w-full aspect-video rounded-xl"
+  src="https://www.youtube.com/embed/b5Wx2NAeY2E?si=r1FumIsbGt6nAt29"
+  title="Payments and transactions for agents"
+  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
+  allowFullScreen
+></iframe>
+
+## x402: pago por solicitud con stablecoins
+
+x402 permite que tu agente pague por solicitudes de API usando <Tooltip tip="Criptomonedas ancladas a un activo estable como el dólar estadounidense (por ejemplo, USDC). 1 USDC está diseñado para siempre equivaler a $1.">stablecoins</Tooltip> sin suscripciones o claves de API. Tu agente solicita un recurso, el servidor le dice el precio, tu agente paga y el servidor entrega los datos.
+
+El nombre proviene del código de estado HTTP `402 Payment Required`, que ha estado reservado en la especificación HTTP desde los años 1990 pero nunca fue ampliamente adoptado. x402 finalmente lo pone en uso.
+
+### Cómo funciona x402
+
+<Steps>
+  <Step title="Tu agente hace una solicitud">
+    Tu agente envía una solicitud HTTP estándar a un endpoint de API, igual que cualquier otra llamada de API.
+  </Step>
+
+  <Step title="El servidor responde con 402 Payment Required">
+    En lugar de devolver datos, el servidor responde con un código de estado `402` e incluye detalles de pago: cuánto cuesta, en qué stablecoin pagar y dónde enviar el pago.
+  </Step>
+
+  <Step title="Tu agente paga">
+    El wallet de tu agente construye y envía un pago onchain basado en las instrucciones del servidor. Esto sucede automáticamente, sin aprobación humana necesaria.
+  </Step>
+
+  <Step title="El servidor entrega los datos">
+    Una vez confirmado el pago, el servidor devuelve los datos solicitados. Todo el flujo toma segundos.
+  </Step>
+</Steps>
+
+Este modelo es poderoso para agentes porque no requiere una relación preexistente entre tu agente y el servicio. Cualquier agente con un wallet financiado puede pagar por cualquier API habilitada para x402 sobre la marcha.
+
+[Aprende más sobre x402 →](https://www.x402.org/)
+
+## Skills: acciones que tu agente puede realizar
+
+Los skills son definiciones de funciones tipadas que describen una acción que tu agente puede invocar. Cada skill especifica un nombre, entradas esperadas y tipo de retorno similar a un esquema de herramienta o función en cualquier integración de uso de herramientas de LLM. Tu agente analiza estas definiciones en runtime y las llama cuando son relevantes.
+
+Los skills cubren acciones como verificar el balance de un token, ejecutar un intercambio, enviar un pago o llamar a un <Tooltip tip="Un programa desplegado onchain que se ejecuta automáticamente cuando se cumplen las condiciones">smart contract</Tooltip>.
+
+### Cómo se ve un skill
+
+Una definición de skill incluye el nombre de la acción, una descripción de lo que hace, las entradas requeridas y la salida esperada. Aquí hay un ejemplo simplificado:
+
+```json Title "Conceptual skill definition"
+{
+  "skill": "check-balance",
+  "description": "Check the token balance of a wallet address",
+  "inputs": {
+    "wallet_address": "The address to check",
+    "token": "The token symbol (e.g., USDC, ETH)"
+  },
+  "output": "The current balance of the specified token"
+}
+```
+
+Tu agente lee esta definición, entiende qué entradas necesita proporcionar y llama al skill cuando es relevante para la tarea en cuestión.
+
+### Proveedores de skills
+
+<Tabs>
+  <Tab title="BANKR Skills">
+    **Qué son:** Skills preconstruidos para agentes ejecutándose en OpenClaw. Los skills de BANKR cubren acciones comunes como intercambios de tokens, verificaciones de balance e interacciones DeFi.
+
+    **Mejor para:** Agentes usando OpenClaw o BANKR que necesitan capacidades onchain listas para usar.
+
+    [Explora los skills de BANKR →](https://github.com/BankrBot/openclaw-skills)
+  </Tab>
+
+  <Tab title="CDP Skills">
+    **Qué son:** Skills proporcionados por la plataforma de desarrolladores de Coinbase. Los skills de CDP se integran con el Agentic Wallet y cubren gestión de wallet, operaciones de tokens e interacciones de protocolos.
+
+    **Mejor para:** Agentes usando Agent SDK con un CDP Agentic Wallet.
+
+    [Explora los skills de CDP →](https://docs.cdp.coinbase.com/agentic-wallet/skills/overview)
+  </Tab>
+</Tabs>
+
+## Siguiente paso
+
+<Card title="Identidad, verificación y autenticación" icon="arrow-right" href="/ai-agents/core-concepts/identity-verification-auth">
+  Haz que tu agente sea descubrible y verificable para que otros agentes y servicios puedan confiar en él.
+</Card>