Guías / Ejecutar Mets (Runs)

Ejecutar Mets (Runs)

Ejecuta el Met de tu workspace por API, con memoria opcional, y lee el resultado.

Ejecutar Mets (Runs)

Un Run es una ejecución del Met de tu workspace sobre un input. Es el corazón de "infraestructura agéntica como servicio": el mismo Met que responde en el chat, ahora disparado por código.

Ejecución básica

const run = await met.runs.create({ input: 'Resume los leads de hoy' });

console.log(run.status);  // 'completed'
console.log(run.output);  // el resultado del Met

El request es POST /workspaces/:id/runs. La respuesta es un recurso run con id opaco (run_…), status, output, livemode y metadata.

Elegir el especialista

Sin más datos, el orquestador del workspace auto-rutea al Met adecuado (igual que en el chat). Puedes dar una pista con met:

await met.runs.create({ met: 'ventas', input: '¿Cuántos leads cerré?' });

En la versión actual met es informativo: el orquestador sigue decidiendo el ruteo.

Memoria: conversaciones

Sin conversation_id, el run corre en una conversación efímera (sin memoria previa). Para darle continuidad, pasa una conversación existente:

await met.runs.create({ input: 'Y el mes pasado?', conversation_id: 1234 });

Leer runs

const run = await met.runs.retrieve('run_01J8…');   // estado + salida

for await (const r of met.runs.iterate()) {           // historial completo
  console.log(r.id, r.status);
}

iterate() recorre todas las páginas por ti (ver Errores y paginación).

Costo

Cada run debita Energía por el mismo ledger de siempre, marcado execution_type='api' y atribuido a la key. En tu dashboard, el consumo por API aparece separado del chat interno.

¿Streaming? Si quieres procesar el resultado a medida que se genera, mira la guía de Streaming.