Documentación

Documentación

Cada agente de Ghosty Studio es una máquina propia: disco, terminal y memoria. Aquí está cómo crearlo, dónde ponerlo a trabajar y cómo hablarle desde tu software.

¿Qué camino tomar?

Todo el índice

Empezar
  • Primeros pasos
    Crea un agente, dale un PDF y mira cómo lo descarga a su máquina, lo lee y te contesta con los datos exactos. Diez minutos, sin código.
  • Conceptos
    Agente, máquina, conversación, turno, canal, conector, skill, motor y plan — el vocabulario de Ghosty Studio.
  • Configura a Ghosty desde tu agente de código
    Identidad, modelo, archivos de conocimiento, skills y servidores MCP — todo por API con el token del agente, y una skill para que Claude Code, Cursor o Codex lo hagan por ti.
  • Recetas
    Un agente cabe en un archivo YAML — título, descripción, instrucciones y canales. Las ocho de casa, cómo subir la tuya y cómo exportar la de un agente.
Canales
  • WhatsApp
    El número se conecta en Sales (WhatsApp Business) y en la ficha del agente eliges qué números contesta; audios, imágenes y PDFs.
  • Teams
    Activa un agente de Studio en un espacio de Ghosty Teams con un @handle; canales, DMs, documentos y tareas.
  • Widget embebido
    Pon un chat con tu agente en tu propio sitio con un iframe. Disponible para agentes de motor EasyBits.
Conectores
  • Conectores
    Cuentas externas a las que el agente accede en tu nombre — Google, Canva, Spotify, Odoo, GitHub — y cómo se conectan.
Protocolos
  • ACP — conecta tu editor
    Conecta Zed, VS Code, JetBrains o neovim a un agente de Ghosty Studio por el Agent Client Protocol.
  • A2A — agente a agente
    Cada agente publica un Agent Card A2A v1.0 para que otros agentes lo descubran; el endpoint de mensajes se abre a terceros próximamente.
  • MCP — herramientas del agente
    Qué herramientas tiene un agente de Ghosty, cómo se nombran y cómo llegan a cada motor por el Model Context Protocol.
  • MCP de la documentación
    Instala la documentación de Ghosty Studio como servidor MCP en Claude Code, Cursor o Codex; tu agente la busca y la lee sin salir del editor.
API
  • Autenticación
    OAuth2 con PKCE para hablar con la API de Ghosty Studio en nombre de una persona — scopes, tokens, errores y cómo obtener un client_id.
  • Referencia de la API
    Todos los endpoints de /api/v2/me — agentes, conversaciones, mensajes, eventos, permisos, archivos, conectores — con su esquema OpenAPI 3.1.
  • Eventos (SSE)
    Catálogo de los eventos del stream de una conversación — started, chunk, tool, permission, artifact, done — y cómo escribir un cliente que no pierda nada.
  • Errores y límites
    Códigos de respuesta de la API de Ghosty Studio, qué significa cada uno y cómo reintentar; tamaños y topes.
Referencia
  • Cambios
    Qué cambió en la plataforma y en esta documentación, por fecha.
  • Seguridad
    Qué aísla a un agente de otro, dónde viven tus llaves, qué puede hacer un agente en un canal público y cómo se borra una cuenta.