Saltar al contenido
Tu IA@https://hoody.com Connect to Hoody

Modo desarrollador

Lo mantuvimos simple. Aquí está Hoody, en concreto.

Cada sección muestra ahora las llamadas exactas a la API del Bot que hay detrás, con Copiar. Todas las llamadas están al final.

Ver las llamadas

hoody / bots

Bots

Habla con tus Bots.
Ellos dirigen a los agentes.

Un Bot es un asistente permanente con un solo chat que conserva toda la conversación. Pídele lo que quieras: abre agentes en tus computadoras, sigue su trabajo y te informa de lo que hicieron. Dale una URL .hoody.bot y compártela con personas e IA de confianza mediante claves con nombre.

Tu primer Bot, chief, ya está listo desde el principio. Hoody AI (gratis) viene integrado. O inicia sesión con ChatGPT. Los ayudantes del Bot pueden usar Claude Pro o Max a través de Claude Code cuando lo permites.

Cómo encajaEjemplo
Tú

Corrige la errata de Mi sitio y el precio de Tienda, y luego ordena las fotos nuevas.

Tu Bot

chiefun solo chat · partes antiguas resumidas · tus límites

Agentes

hechoCorregir la errata de Mi sitio

te preguntaCorregir el precio de Tienda

trabajandoOrdenar fotos nuevas

Tus computadoras
Mi sitio Tienda Fotos

Cada agente es una sesión completa del Hoody Agent en una de tus computadoras.

En concreto

Tu primer Bot
GET /api/v1/agent/bots/chiefchief se crea la primera vez que lo usas, así que la lista de Bots nunca está vacía.
Dónde se ejecuta
https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/botsLos Bots se ejecutan en el Hoody Agent (agent-1). No en el servicio de la app de chat en /api/bot/.
hoody / how it flows

Un mensaje llega hasta el final. Vuelve con un informe.

Tú

desde cualquiera de estos

InformeListo. Tienda está arreglada.

Tus computadoras

Tu Bot

recibe tu mensaje al instante y informa cuando termina

Agent

sus ayudantes

Agent

sus ayudantes

  • Mi sitioactualizar
  • Tiendaarreglar
  • Fotoshacer copia de seguridad

EjemploTodo se ejecuta en tus computadoras. Tu Bot conoce cada una.

En concreto

Sus agentes
GET /api/v1/agent/bots/chief/delegates?state=openCada agente delegado es una sesión normal que se puede leer o conectar con las rutas /sessions. Las abiertas llevan capability y current_step.
Su turno en vivo
GET /api/v1/agent/sessions/{session_id}/streamTexto de la respuesta y razonamiento a medida que se escriben, llamadas a herramientas y el final de cada turno. session_id viene de GET /bots/{id} una vez que el Bot ha recibido su primer mensaje.
Más: mira un turno completo, un Bot a la vez

Pides una vez. Reparte el trabajo.

Responde, abre agentes para las partes largas y vuelve a ti con sus preguntas y sus resultados.

Turno de ejemplo

Tú, 09:12

Corrige la errata del precio en Mi sitio. Y averigua por qué el pago en Tienda se volvió lento.

Chief, 09:12

Me pongo con ello. Abro dos agentes: uno en Mi sitio para la corrección y otro en Tienda para medir el tiempo del pago. Te informo.

abrió 2 agentes · Mi sitio, Tienda

Chief, 09:19

El agente de Mi sitio corrigió la errata y quiere ejecutar esto. ¿Lo permites?

bash: ./publish.sh

Tú, 09:20

Sí, adelante.

[informe] El agente de Mi sitio terminó: errata corregida, sitio actualizado.

Chief, 09:31

Hecho en Mi sitio: la corrección ya está activa. El pago se queda esperando una consulta lenta. El agente de Tienda tiene una corrección lista para probar.

Escribe cuando quierasUn mensaje enviado mientras está ocupado espera su turno. Envía una corrección y lee ambos juntos.
Trabaja en tus computadorasLos agentes se ejecutan donde están tu código y tus archivos, y siguen trabajando después de que cierras la pestaña.
Vuelve a preguntarLa solicitud de un agente solo se aprueba con un mensaje tuyo, nunca con el informe de un agente.

En concreto

Tu mensaje
POST /api/v1/agent/bots/chief/messagesResponde 202 con message_id, state y turn_id; state: queued mientras el Bot está ocupado.
Su respuesta
GET /api/v1/agent/bots/chief/streamSSE: una trama state, luego una row por fila de registro; reanuda con Last-Event-ID.
Detener un agente
POST /api/v1/agent/bots/chief/delegates/{sid}/stopDetiene al instante el trabajo de ese agente, nunca el del Bot. {"close": true} también cierra su sesión.
Dilo en voz alta
POST /api/v1/agent/bots/chief/messages/audioUna grabación wav o mp3 se transcribe y se envía como tu mensaje.
hoody / api

Dale a tu Bot una URL pública. Conecta personas, apps e IA de confianza.

Una URL, tres formas de entrar: como modelo para apps y SDK que aceptan una URL base (formato de OpenAI o de Anthropic), como servidor MCP o por HTTP simple desde un script.

chief · URL del Bot

https://<label>.hoody.bot
Código QR de un Bot, con la marca del Bot en el centro, tal como lo dibuja el Hub: un teléfono que lo escanea abre la página de chat del Bot. Este ejemplo abre hoody.com/bots.

1En una app

Tu appID de ejemplo
Formato
URL base<Bot URL>/v1
Modelobot:global/chief
Clave de APItu clave hbk_
URL base<Bot URL>
Modelobot:global/chief
Clave de APItu clave hbk_
URL del servidor<Bot URL>/mcp
TransporteHTTP, POST en cada solicitud
Clave de APItu clave hbk_

Finalizaciones de chat, respuestas y modelos. Solo se envía el último mensaje del usuario; el prompt del sistema y los ajustes propios de la app se omiten.

Mensajes y modelos, en la URL sin /v1. Solo se envía el último mensaje del usuario; el prompt de sistema y los ajustes propios de la app se omiten.

Tu Bot como servidor MCP: respuestas JSON-RPC, sin sesión que mantener y sin flujo de eventos.

2Desde un script

HTTP simple

  • POST /bots/chief/messages

    Dale una tarea desde un script, una tarea cron u otra IA.

  • GET /bots/chief/stream

    Sigue las respuestas terminadas y los eventos de los agentes. El flujo de sesión del Bot muestra el texto de la respuesta a medida que se escribe.

  • POST /bots/chief/delegates/{sid}/stop

    Detén un agente; el Bot sigue en marcha.

3Quién entra

Da a cada persona o app de confianza una clave con nombre. Páusala, define una caducidad o una restricción IPv4, o revócala por separado.

Todas las personas con una clave comparten una conversación. Comparte solo con personas e IA de confianza.

Limita un Bot a un reino: sus agentes solo ven las computadoras de ese reino.

En concreto

Base del Bot
https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{realm}/{bot}OpenAI usa <base>/v1, Anthropic la base, MCP <base>/mcp. {realm} es global o un ID hexadecimal de 24 caracteres. GET /bots/{id} los lista en urls. Bot compartido: https://<label>.hoody.bot/v1/chat/completions con una clave Bearer.
Enviar un mensaje
curl -X POST "<agent>/api/v1/agent/bots/chief/messages" -H "Authorization: Bearer <token>" -d '{"text":"Ship it"}'Hasta 64 KiB de texto; responde 202.
Detener un agente
POST /api/v1/agent/bots/chief/delegates/{sid}/stop {"close":true}Detiene a un delegado, nunca al Bot.
hoody / guardrails

En lenguaje natural. Esa es toda la configuración.

Escribe con tus palabras lo que tu Bot nunca debe hacer. Guarda. Listo.

  • Sin sintaxis
  • Cada agente los recibe
  • Las tareas de riesgo se revisan antes de empezar

chief · reglasEjemplo

nunca hagas push a main, abre un PR y espérame no toques facturación, DNS ni pagos la base de datos de producción es de solo lectura si una tarea cuesta más de 20 US$, detente y pregunta ¿no estás seguro? pregúntame, no adivines

En concreto

Reemplazar reglas
PUT /api/v1/agent/bots/chief/guardrails {"guardrails":"Never push to main."}Un campo de texto; el Bot recibe cada línea marcada con [guardrails updated] antes de su siguiente mensaje.
Nivel de rigor
"guardrail_check": "strict"strict (predeterminado), lenient o off. docs / api / agent / bots ↗

En concreto

Enviar desde cualquier lugar
POST /api/v1/agent/bots/chief/messages {"text":"Is staging up?"}Responde 202; queued mientras el Bot está ocupado. Añade un Idempotency-Key para reintentar sin riesgo.
Reanudar el flujo
GET /api/v1/agent/bots/chief/stream?since=154Server-Sent Events; el id de cada trama de fila es su seq, por eso Last-Event-ID se reanuda solo.
Accesos de voz
…/bots/{id}/voice · …/bots/{id}/realtimeUna sola conexión de voz activa por Bot a la vez; takeover=true la reemplaza. docs / api / agent / bots ↗
Más: el registro
Ejemplo: cuatro dispositivos, un Bot, un solo registro

Cuatro dispositivos (un teléfono, una laptop, una terminal y una aplicación de IA) están conectados al mismo Bot. El teléfono y la laptop envían en el mismo instante, 22:31; los mensajes llegan como #152 y luego #153, y el Bot responde como #154. Todos los dispositivos ven el mismo orden. Los turnos anteriores se condensan en un resumen breve, filas de #1 a #120; los turnos más recientes, de #121 a #154, se conservan palabra por palabra. El registro completo conserva todas las filas.

Todos los dispositivos, una conversación. Tu teléfono, laptop, terminal y aplicaciones de IA se conectan a la vez al mismo Bot, y todos ven los mensajes en el mismo orden. Quienes tienen la clave también lo comparten, así que compártelo solo con personas de confianza.

Cada mensaje recibe el número siguiente. Dos enviados en el mismo instante llegan como #152 y luego #153. Uno enviado mientras el Bot está ocupado espera su siguiente turno.

El Bot sigue aunque se llene el contexto. Cuando se llena la ventana de contexto del modelo, los turnos anteriores se condensan en un resumen breve, los más recientes se conservan palabra por palabra y el Bot sigue. El registro conserva todas las filas; al olvidar, pasan al archivo.

Qué contiene una fila
Cada fila tiene seq, at, role (user, bot, event o system) y text. También puede tener session_id. El registro se pagina por seq; el flujo envía cada fila nueva en cuanto se escribe.
Cambiar de modelo
Un modelo nuevo empieza con la siguiente sesión del Bot: reset pasa el registro al archivo y abre la sesión nueva. El archivo se puede leer hasta que lo purgues.
Memoria que guardan tus agentes
Los agentes también guardan y buscan su propia memoria (por palabra clave, por significado y por enlaces entre elementos), sin depender de una sola aplicación de IA. docs / api / agent / memory ↗

En concreto

Leer el registro
GET /api/v1/agent/bots/chief/logFilas en orden, paginadas por seq.
Seguirlo
GET /api/v1/agent/bots/chief/streamUna trama state, luego filas; un cursor que pasó al archivo responde lagged.
Olvidar
POST /api/v1/agent/bots/chief/forgetLéelo después con GET …/archive; bórralo con POST …/purge.
Más: hooks

Pon un hook. Tu script ve la llamada primero y la respuesta al final.

Un hook envía las llamadas HTTP que coinciden al Bot, o a la mayoría de los demás servicios de tus computadoras, primero por uno de tus scripts de Exec. Las actualizaciones a WebSocket en una ruta que coincide se rechazan, así que deja fuera de la coincidencia rutas como las de voz del Bot. A la ida, puede observar, comprobar, cambiar, responder o bloquear las llamadas. A la vuelta, puede leer la respuesta y cambiarla antes de que la reciba quien llama. Nada que parchear.

Un circuito desde quien llama hasta el Bot o la mayoría de los demás servicios de tus computadoras. Las llamadas entran por arriba y las respuestas vuelven por abajo. Un script de Exec cruza ambos sentidos, así que ve cada llamada a la ida y puede ver cada respuesta a la vuelta. Cada hook tiene un límite de tiempo, de 500 ms por defecto.

EntradaDe ida

  • ObservarRegistra quién llamó y qué pidió, y luego déjala pasar.Ver scriptOcultar script

    Regla: POST /api/v1/agent/bots/* → /bot-audit

    module.exports = async function (req, res, metadata) {
      if (!metadata.hook) {
        res.writeHead(404);
        return res.end();
      }
      const ip = req.headers['x-real-ip'];
      console.log(metadata.hook.auditId,
        metadata.hook.origPath, ip);
      await metadata.hook.forward(req, res);
    };

    El script ve la IP real del cliente. Si se llama sin un hook, metadata.hook no contiene nada, así que responde 404. forward() pasa la llamada al Bot tal como estaba.

  • ComprobarDeja pasar solo a quien haya iniciado sesión. Un límite de solicitudes va en el mismo punto.Ver scriptOcultar script

    Regla: any method except OPTIONS /api/v1/agent/bots/* → /identity-gate

    module.exports = async function (req, res, metadata) {
      if (!metadata.hook) {
        res.writeHead(404);
        return res.end();
      }
      const user = verifyClaim(
        req.headers['x-hoody-claim']);
      if (!user) {
        res.writeHead(401);
        return res.end();
      }
      await metadata.hook.forward(req, res,
        { headers: {
          'x-hoody-claim': null,
          'x-hoody-user': user.username,
        } });
    };

    verifyClaim comprueba una credencial de inicio de sesión de Hoody firmada con ED25519; la documentación tiene el script completo. Quien no tenga una recibe un 401 y nunca llega al Bot. Esta regla también rechazaría las rutas de voz WebSocket; acótala para dejarlas fuera.

  • CambiarReescribe el método, la ruta, los encabezados o el cuerpo antes de que llegue.
  • BloquearRechaza las subidas que no pasan un análisis antivirus o las llamadas que superan tu límite.
  • ResponderResponde tú, por ejemplo “Volvemos pronto”, y el Bot nunca ve la llamada.Ver scriptOcultar script

    Regla: POST /api/v1/agent/bots/* → /bot-gate

    module.exports = async function (req, res, metadata) {
      if (!metadata.hook) {
        res.writeHead(404);
        return res.end();
      }
      if (process.env.MAINTENANCE) {
        res.writeHead(503);
        return res.end('Back soon');
      }
      await metadata.hook.forward(req, res,
        { headers: { cookie: null } });
    };

    Una respuesta que envía el script nunca llega al Bot. forward() también puede cambiar el método, la ruta, los encabezados o el cuerpo; un encabezado definido como null se elimina.

SalidaDe vuelta

  • Leer la respuestaMira su estado, sus encabezados y su cuerpo antes que quien llama.
  • ReescribirEnvía la respuesta tal como está o envía la tuya.Ver scriptOcultar script

    Regla: any method except OPTIONS /api/v1/agent/bots/* → /bot-answer

    module.exports = async function (req, res, metadata) {
      if (!metadata.hook) {
        res.writeHead(404);
        return res.end();
      }
      const up = await metadata.hook.fetchUpstream(req);
      if (up.status === 401) {
        res.writeHead(401);
        return res.end('Please sign in again');
      }
      res.setHeader('x-hoody-hook-audit', metadata.hook.auditId);
      await metadata.hook.pipeResponse(up, res,
        { method: req.method });
    };

    fetchUpstream() obtiene la respuesta del Bot sin enviarla, así que el script la lee primero; pipeResponse() la envía. Una respuesta transmitida termina en el límite de tiempo del hook, 30 000 ms como máximo.

  • Limpiar encabezadosQuita los encabezados privados de las respuestas y añade una CSP.

Cada hook tiene un límite de tiempo, de 500 ms por defecto. Si el script falla o se queda sin tiempo, la llamada se detiene ahí. docs / proxy / hooks ↗

En concreto

Añadir un hook
POST /api/v1/computers/{id}/proxy/hooks/agent · If-Match: file:v<N> {"match":{"method":["POST"],"path":"/api/v1/agent/bots/*"},"script":{"path":"/bot-audit"},"timeout":500}El servidor asigna el id al hook. Las reglas se ejecutan en orden y gana la primera que coincide.
Leer la versión
GET /api/v1/computers/{id}/proxy/hooks/agentCada cambio en los hooks necesita If-Match: file:v<N> con la versión actual.
El script
POST /api/v1/exec/scripts/write {"path":"bot-audit.js","content":"module.exports = async function (req, res, metadata) { … }"}El cuerpo del script solo muestra la estructura: pon tu código de auditoría en lugar de { … }. script.path nombra un script de tu propio hoody-exec. Escríbelo en tu enlace de exec; /bot-audit sirve bot-audit.js. docs / api / exec / script-management ↗

Empieza gratis, en una línea.

Gratis para empezar, sin tarjeta: Hoody AI viene integrado y la IA que ya usas también funciona.

Sin código
Código
Tu IA@https://hoody.com Connect to Hoody

Funciona en ChatGPT, Claude o cualquier IA que pueda abrir una página. Cópialo y pégalo.

Tu IA
@https://hoody.com Connect to Hoody
docs / foundation / agent-skill-bundle
Navegador
https://hub.hoody.com
docs / kit / agent
Terminal
ssh hoody.comCualquier computadora con un cliente SSH, en una terminal interactiva. Sin nada que instalar.
docs / kit / agent
Habilidad
npx skills add https://hoody.com/SKILLS/SKILL.mdnpx skills add HoodyNetwork/hoody-sdkEl segundo agrega al disco todas las páginas de la documentación, para usarlas sin conexión.
docs / foundation / agent-skill-bundle
CLI
npm install -g hoody-sdkcurl -fsSL https://install.hoody.com | shEl segundo es para Linux y macOS. Sin instalar: npx hoody-sdk <command>
docs / foundation / cli
SDK
npm install hoody-sdkTypeScript. Node.js 20.19 o posterior, Bun, Deno.
docs / getting-started / quickstart
HTTP API
curl -H "Authorization: Bearer <token>" https://api.hoody.com/api/v1/computers/
docs / api / authentication
SDK navegador
<script src="https://cdn.jsdelivr.net/npm/hoody-sdk/dist/hoody-sdk.browser.min.js"></script>Expone window.HoodySDK. Fija una versión para producción y da a las páginas tokens de corta duración y con alcance limitado.
docs / getting-started / quickstart

Desde 2021

De la privacidad a la infraestructura para agentes

hoody / kit

Qué incluyen tus computadoras

Cada servicio tiene su propio enlace. Ábrelo, compártelo o pásaselo a tu IA. Quien tenga el enlace puede abrirlo hasta que lo protejas. Los enlaces del Kit tienen la forma https://{p}-{c}-<kit>-1.{node}.computers.hoody.com, donde {p} es tu proyecto, {c} una de tus computadoras y {node} su servidor.

Computadoras

Bots

API