Skip to main content

Herramientas de IA

Versión Alpha: Esta es la documentación del motor v2. Las funciones y APIs pueden cambiar.

Cómo Funciona

Las herramientas de IA de Floaty te permiten usar asistentes de programación como Claude Code, Cursor y GitHub Copilot para crear y editar juegos directamente desde tu IDE. Sin copiar y pegar entre el navegador y el editor.

  1. Genera un token en tu perfil — un token por playground o plugin
  2. Instala un conjunto de habilidades para tu agente de IA
  3. Dale al agente tu token y empieza a construir

Los tokens son de corta duración (12, 24 o 48 horas) y están vinculados a un solo recurso. Un token de playground permite al agente leer y escribir scripts para ese playground. Un token de plugin permite al agente leer y escribir borradores de plugins y crear versiones.

Obtener un Token

  1. Inicia sesión y ve a tu perfil
  2. Desplázate hasta Tokens de API y haz clic en Nuevo token
  3. Selecciona Playground o Plugin y elige tu recurso (o crea uno nuevo)
  4. Elige una expiración (12h, 24h o 48h) y haz clic en Generar token
  5. Copia el token — puedes copiarlo de nuevo en cualquier momento desde la lista de tokens

Cada token está vinculado a un recurso. Si necesitas editar tanto un playground como un plugin, necesitarás dos tokens.

Referencia de la API

URL base: https://floaty.dev/api/v1

Todas las solicitudes requieren estos encabezados: Authorization: Bearer <token>, Content-Type: application/json y Accept: application/json.

Endpoints de Playground

Método Ruta Descripción Acceso
GET /api/v1/playground Leer script, metadatos, plugins Propietario + colaboradores
PUT /api/v1/playground Escribir script Propietario + colaboradores
PUT /api/v1/playground/meta Actualizar título, fondo, visibilidad Solo propietario
PUT /api/v1/playground/plugins Actualizar asociaciones de plugins Solo propietario
GET /api/v1/playground/plugins/{uuid} Leer script y versiones de plugin adjunto Propietario + colaboradores
GET /api/v1/playground/plugins/{uuid}/releases/{releaseUuid} Leer versión específica de plugin adjunto Propietario + colaboradores

Endpoints de Plugin

Método Ruta Descripción Acceso
GET /api/v1/plugin Leer borrador, metadatos, última versión Solo propietario
PUT /api/v1/plugin Escribir borrador Solo propietario
PUT /api/v1/plugin/meta Actualizar título, descripción, visibilidad Solo propietario
POST /api/v1/plugin/release Crear nueva versión desde el borrador actual Solo propietario
GET /api/v1/plugin/releases Listar todas las versiones Solo propietario
GET /api/v1/plugin/releases/{uuid} Leer script de una versión específica Solo propietario

Códigos de Error

Código Significado
401 Token expirado o inválido — regenera en tu perfil
403 Tipo de token incorrecto o permisos insuficientes
422 Error de validación (campo faltante, script mayor a 1MB)
429 Límite de velocidad (60 solicitudes/minuto en endpoints de escritura) — espera y reintenta

Instalar el Conjunto de Habilidades

Claude Code

BASE=https://raw.githubusercontent.com/floaty-dev/agent-skills/main/claude-code/floaty
for f in SKILL.md api-reference.md engine-reference.md; do
  curl -sL "$BASE/$f" --create-dirs -o ".claude/skills/floaty/$f"
done

Luego usa /floaty en Claude Code para iniciar una sesión.

Cursor

curl -sL https://raw.githubusercontent.com/floaty-dev/agent-skills/main/cursor/.cursor/rules/floaty.mdc \
  --create-dirs -o .cursor/rules/floaty.mdc

GitHub Copilot

curl -sL https://raw.githubusercontent.com/floaty-dev/agent-skills/main/copilot/.github/instructions/floaty.instructions.md \
  --create-dirs -o .github/instructions/floaty.instructions.md

Cómo Usar tu Agente

Una vez instalado el conjunto de habilidades y con tu token proporcionado, prueba indicaciones como:

  • "Lee el script actual del playground y explica qué hace"
  • "Agrega controles de teclado para mover al jugador con las flechas"
  • "Crea un juego de plataformas simple con gravedad y salto"
  • "Lee el script del plugin y agrega una función de barra de vida"

El agente usará la API para leer el script actual, hacer cambios y escribirlo de vuelta. Puedes ver el resultado en tu navegador en https://floaty.dev/es/playground/{uuid}.

Consejo: El editor del playground no es multiusuario. Si tienes el editor abierto mientras un agente escribe en el mismo playground a través de la API, al hacer clic en Ejecutar se guardará la versión que ves en el editor — sobrescribiendo lo que el agente haya cambiado desde que lo abriste. Usa la URL de vista previa a pantalla completa cuando trabajes con un agente.

  • Editor: https://floaty.dev/es/playground/{uuid}
  • Vista previa (pantalla completa): https://floaty.dev/es/playground/{uuid}/preview

Puedes pedirle a tu agente el UUID — está incluido en la respuesta de la API al leer un playground.

Verificar Actualizaciones de Habilidades

Cada archivo de habilidad verifica actualizaciones al inicio de cada sesión comparando el archivo local con la última versión en el repositorio de habilidades . Si hay una actualización disponible, el agente preguntará antes de hacer cambios.

Para actualizar manualmente, vuelve a ejecutar el comando de instalación para tu agente.

Más Información