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.
Corrige la errata de Mi sitio y el precio de Tienda, y luego ordena las fotos nuevas.
chiefun solo chat · partes antiguas resumidas · tus límites
hechoCorregir la errata de Mi sitio
te preguntaCorregir el precio de Tienda
trabajandoOrdenar fotos nuevas
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/ chief chiefse crea la primera vez que lo usas, así que la lista de Bots nunca está vacía.- Dónde se ejecuta
https://Los Bots se ejecutan en el Hoody Agent ({p}-{c}-agent-1.{node}.computers.hoody.com/ api/ v1/ agent/ bots agent-1). No en el servicio de la app de chat en/api/bot/.
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 /Cada agente delegado es una sesión normal que se puede leer o conectar con las rutasapi/ v1/ agent/ bots/ chief/ delegates ?state=open /sessions. Las abiertas llevancapabilityycurrent_step.- Su turno en vivo
GET /Texto de la respuesta y razonamiento a medida que se escriben, llamadas a herramientas y el final de cada turno.api/ v1/ agent/ sessions/ {session_id}/ stream session_idviene deGET /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.
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.
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.
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.
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.
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.
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.
Corregir la errata del precio
trabajandote preguntahechoen Mi sitiomodelo: Hoody AI (gratis)
ahora: editando la página de preciosespera: bash: ./publish.shinformó
Medir el tiempo del pago
trabajandote preguntahechoen Tiendamodelo: Hoody AI (gratis)
ahora: midiendo el tiempo del pagoinformó
Tú, 10:02
Agrega el nuevo menú de otoño a Tienda y asegúrate de que las pruebas de pedidos sigan pasando.
Tendero, 10:02
Me pongo con ello. Un agente agrega el menú y otro ejecuta las pruebas de pedidos. Te aviso cuando terminen los dos.
Tendero, 10:14
El agente del menú está listo para publicar el menú de otoño. ¿Lo permites?
bash: ./menu.sh
Tú, 10:15
Sí, publícalo.
Tendero, 10:21
Hecho: el menú de otoño ya está activo en Tienda y las 48 pruebas de pedidos pasan.
Agregar el menú de otoño
trabajandote preguntahechoen Tiendamodelo: Hoody AI (gratis)
ahora: agregando 12 platos nuevosespera: bash: ./menu.shinformó
Ejecutar las pruebas de pedidos
trabajandote preguntahechoen Tiendamodelo: Hoody AI (gratis)
ahora: ejecutando 48 pruebas de pedidosinformó
Tú, 21:40
Fotos está casi llena. Limpia los duplicados y revisa la copia de seguridad.
Archivista de fotos, 21:40
Me pongo con ello. Un agente busca duplicados y otro revisa la copia de seguridad. Te informo.
Archivista de fotos, 21:52
El agente de limpieza encontró 1240 duplicados. ¿Los borras?
bash: ./clean.sh
Tú, 21:53
Sí, bórralos.
Archivista de fotos, 22:05
Listo: 1240 duplicados eliminados, 18 GB libres de nuevo. La copia de seguridad de anoche está completa.
Eliminar duplicados
trabajandote preguntahechoen Photosmodelo: Hoody AI (gratis)
ahora: comparando fotosespera: bash: ./clean.shinformó
Revisar la copia de seguridad
trabajandote preguntahechoen Photosmodelo: Hoody AI (gratis)
ahora: leyendo la copia de seguridadinformó
Tú, 08:03
¿Mi sitio está en línea? Alguien dice que el formulario de contacto no funciona.
Vigía del sitio, 08:03
Lo reviso ahora. Un agente prueba el sitio y otro mira el formulario. Te informo.
Vigía del sitio, 08:11
El agente del formulario encontró el error y tiene una corrección. ¿Lo publicas?
bash: ./publish.sh
Tú, 08:12
Sí, publícalo.
Vigía del sitio, 08:19
Listo: Mi sitio está en línea y el formulario de contacto vuelve a funcionar. El agente del formulario lo probó tras la corrección.
Corregir el formulario de contacto
trabajandote preguntahechoen Mi sitiomodelo: Hoody AI (gratis)
ahora: leyendo errores del formularioespera: bash: ./publish.shinformó
Revisar cada página
trabajandote preguntahechoen Mi sitiomodelo: Hoody AI (gratis)
ahora: abriendo 40 páginasinformó
Tú, 15:30
¿Cuál de tres herramientas de boletines es la más barata para 5000 lectores?
Compañero de investigación, 15:30
En ello. Dos agentes revisan las herramientas. Volveré con una sola opción.
Compañero de investigación, 15:41
El agente de precios quiere guardar sus notas en Shop. ¿Lo permites?
write: notes/tools.md
Tú, 15:42
Sí, guárdalas.
Compañero de investigación, 15:47
Listo: la herramienta B es la más barata para 5000 lectores. Las notas en Shop incluyen los tres precios.
Comparar precios
trabajandote preguntahechoen Tiendamodelo: Hoody AI (gratis)
ahora: leyendo tres páginas de preciosespera: write: notes/tools.mdinformó
Comparar funciones
trabajandote preguntahechoen Tiendamodelo: Hoody AI (gratis)
ahora: enumerando las funcionesinformó
En concreto
- Tu mensaje
POST /Respondeapi/ v1/ agent/ bots/ chief/ messages 202conmessage_id,stateyturn_id;state: queuedmientras el Bot está ocupado.- Su respuesta
GET /SSE: una tramaapi/ v1/ agent/ bots/ chief/ stream state, luego unarowpor fila de registro; reanuda conLast-Event-ID.- Detener un agente
POST /Detiene al instante el trabajo de ese agente, nunca el del Bot.api/ v1/ agent/ bots/ chief/ delegates/ {sid}/ stop {"close": true}también cierra su sesión.- Dilo en voz alta
POST /Una grabación wav o mp3 se transcribe y se envía como tu mensaje.api/ v1/ agent/ bots/ chief/ messages/ audio
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 1En una app
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.
Ejemplo Usar un Bot como modelo
Habla con tu Bot chief como con cualquier modelo de IA, desde cualquier app que use el formato de OpenAI.
Usa mi Bot chief como el modelo de mi propia app.
import OpenAI from 'openai';
const chief = new OpenAI({
baseURL: 'https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/global/chief/v1',
apiKey: 'any',
});
const res = await chief.chat.completions.create({
model: 'bot:global/chief',
messages: [{ role: 'user', content: 'Is the shop up?' }],
});import requests
r = requests.post(
"https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/global/chief/v1/chat/completions",
json={
"model": "bot:global/chief",
"messages": [{"role": "user", "content": "Is the shop up?"}],
},
)
print(r.json())BASE="https://{p}-{c}-agent-1.{node}.computers.hoody.com"
curl -X POST "$BASE/api/v1/agent/bots/global/chief/v1/chat/completions" \
-H "Content-Type: application/json" \
-d '{"model": "bot:global/chief", "messages": [{"role": "user", "content": "Is the shop up?"}]}'curl -X POST "https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/global/chief/v1/chat/completions" \
-H "Content-Type: application/json" \
-d '{"model": "bot:global/chief", "messages": [{"role": "user", "content": "Is the shop up?"}]}'import requests
r = requests.post(
"https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/global/chief/v1/chat/completions",
json={
"model": "bot:global/chief",
"messages": [{"role": "user", "content": "Is the shop up?"}],
},
)
print(r.json())https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request?url=https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/global/chief/v1/chat/completions&method=POST&json={"model":"bot:global/chief","messages":[{"role":"user","content":"Is%20the%20shop%20up?"}]}&response=transparent2Desde 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.
Ejemplo Dar una tarea a un Bot
Pide a tu Bot chief que compruebe que la tienda está en línea.
Pide a mi Bot chief que compruebe que la tienda está en línea.
hoody -c {c} agent bots messages send \
--id chief \
--text "Check that the shop is up"import { HoodyClient } from 'hoody-sdk';
const hoody = new HoodyClient({ baseURL: 'https://api.hoody.com', token: process.env.HOODY_TOKEN });
const box = await hoody.withComputer('{c}');
const result = await box.agent.bots.sendMessage('chief', { text: 'Check that the shop is up' });
console.log(result.state);import requests
r = requests.post(
"https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/chief/messages",
json={"text": "Check that the shop is up"},
)
print(r.json())BASE="https://{p}-{c}-agent-1.{node}.computers.hoody.com"
curl -X POST "$BASE/api/v1/agent/bots/chief/messages" \
-H "Content-Type: application/json" \
-d '{"text": "Check that the shop is up"}'curl -X POST "https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/chief/messages" \
-H "Content-Type: application/json" \
-d '{"text": "Check that the shop is up"}'import requests
r = requests.post(
"https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/chief/messages",
json={"text": "Check that the shop is up"},
)
print(r.json())https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request?url=https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/chief/messages&method=POST&json={"text":"Check%20that%20the%20shop%20is%20up"}&response=transparent3Quié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}esglobalo un ID hexadecimal de 24 caracteres.GET /bots/{id}los lista enurls. Bot compartido:https://<label>.hoody.bot/v1/chat/completionscon 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.
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
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),lenientooff. docs / api / agent / bots ↗
En concreto
- Enviar desde cualquier lugar
POST /api/v1/agent/bots/chief/messages {"text":"Is staging up?"}Responde 202;queuedmientras el Bot está ocupado. Añade unIdempotency-Keypara 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 suseq, por esoLast-Event-IDse reanuda solo.- Accesos de voz
…/bots/{id}/voice · …/bots/{id}/realtimeUna sola conexión de voz activa por Bot a la vez;takeover=truela reemplaza. docs / api / agent / bots ↗
Más: el 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
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
Memoria que guardan tus agentes
En concreto
- Leer el registro
GET /api/v1/agent/bots/chief/logFilas en orden, paginadas porseq.- Seguirlo
GET /api/v1/agent/bots/chief/streamUna tramastate, luego filas; un cursor que pasó al archivo respondelagged.- Olvidar
POST /api/v1/agent/bots/chief/forgetLéelo después conGET …/archive; bórralo conPOST …/purge.- Documentación
- docs / api / agent / bots ↗
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.
EntradaDe ida
ObservarRegistra quién llamó y qué pidió, y luego déjala pasar.Ver scriptOcultar script
Regla:
POST /api/v1/agent/bots/*→/bot-auditmodule.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.hookno 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-gatemodule.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, } }); };verifyClaimcomprueba 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-gatemodule.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 comonullse 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-answermodule.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 necesitaIf-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.pathnombra un script de tu propio hoody-exec. Escríbelo en tu enlace de exec;/bot-auditsirvebot-audit.js. docs / api / exec / script-management ↗- Documentación
- docs / foundation / proxy / hooks ↗
Empieza gratis, en una línea.
Gratis para empezar, sin tarjeta: Hoody AI viene integrado y la IA que ya usas también funciona.
Funciona en ChatGPT, Claude o cualquier IA que pueda abrir una página. Cópialo y pégalo.
- 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>Exponewindow.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