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.
  • Plan y avances
    En los trabajos largos el agente te muestra su plan vivo, entrega cada avance en el hilo y deja la respuesta final debajo.
  • 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 web
    Una burbuja de chat con tu agente en tu propio sitio, con una línea de código y sólo en los dominios que autorices.
  • Messenger
    Conecta tu página de Facebook para que el agente conteste en Messenger y en los comentarios de tus anuncios, y enséñale a Meta qué leads sí compran.
Conectores
  • Conectores
    Cuentas externas a las que el agente accede en tu nombre — Shopify, Mercado Libre, Google Drive, Gmail, Stripe, Mercado Pago, Notion, HubSpot, monday.com, Zapier, Odoo, GitHub y más — y cómo se conectan desde la web, la app o el CLI.
  • Navegador (Ghosty para Chrome)
    La extensión Ghosty para Chrome le presta tu navegador a tu agente, con las sesiones que ya tienes abiertas. Instalación, uso desde /c, la app y la terminal, tools browser_*, atajos, programados y privacidad.
Software Factory
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.
CLI
  • CLI — Ghosty desde la terminal
    Instala el CLI oficial de Ghosty Studio, entra con tu cuenta y configura, prueba y platica con tus agentes desde la terminal.
  • Referencia de comandos
    Todos los comandos del CLI de Ghosty con ejemplos (agentes, canales, conectores, credenciales, turnos, sitios, navegador), opciones globales y códigos de salida.
  • CLI para agentes de código
    Cómo Claude Code, Codex o Cursor usan el CLI de Ghosty por ti — login conducido por el agente, salida JSON, códigos de salida y la skill ghosty-agent.
  • Partners — un agente para cada uno de tus clientes
    Con ghosty partner le das un asistente a cada negocio que usa tu producto — un agente compartido que sólo usa tu MCP, memoria por cliente y credenciales para tu servidor.
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 — configuración del agente, bases de datos, documentos, turnos, WhatsApp, tableros, cuenta, conversaciones, archivos y partners — 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.