Construye tu asistente, paso a paso.

Primeros pasos

1. Confirma tu correo e inicia sesión.
2. En Conexiones, guarda una conexión de IA con nombre y tu propia clave de OpenAI, Ollama Cloud o un servicio compatible con OpenAI.
3. En Asistentes, crea uno, elige la conexión y el modelo, y escribe qué trabajo debe hacer y cómo debe responder.
4. Prueba una pregunta en el chat. Ajusta las instrucciones y guarda los cambios antes de volver a probar.

La clave de IA se guarda cifrada y no vuelve a mostrarse. El consumo del modelo lo cobra tu proveedor. Si compartes conversaciones pagadas con tu clave, ese consumo también corre por tu cuenta.

Conocimiento y respuestas

Sube documentos PDF con texto seleccionable, TXT, Markdown, CSV o JSON. Assistant Studio conserva el original y prepara fragmentos para buscar solo lo relevante de cada consulta. Los PDF escaneados aún necesitan OCR externo.

También puedes crear respuestas verificadas: preguntas y respuestas aprobadas que se pueden editar en la interfaz o cargar desde CSV. Una coincidencia exacta se entrega sin llamar al modelo. En otras formulaciones, el modelo ayuda a elegir una respuesta existente.

Usa documentos para información extensa y respuestas verificadas cuando la redacción final deba permanecer bajo tu control.

Compartir y permisos

Los invitados pueden conversar, pero no editar el asistente ni ejecutar herramientas externas. Los enlaces públicos que usan la clave del propietario también tienen cupos por asistente y visitante.

Automatizaciones

En Automatizar, escribe una instrucción y elige una ejecución cada hora, cada 24 horas, a una hora local diaria o al recibir un webhook. También puedes pulsar Ejecutar ahora. El asistente usa la conexión de IA del propietario.

Si habilitas acciones externas para una automatización, esta puede crear o modificar datos sin que estés presente. Activa solo las herramientas que necesitas y revisa primero una ejecución manual.

Los resultados quedan en el historial. Puedes además recibirlos por correo y enviarlos a un webhook HTTPS de tu sistema.

Actividad y copias

La pestaña Actividad muestra uso, resultados y llamadas a herramientas. Los eventos detallados se conservan 30 días y los resúmenes diarios, 90 días. Cada persona conserva sus conversaciones; el propietario puede revisar métricas sin copiar el texto del chat a los eventos de actividad.

El propietario puede exportar un TAR con la configuración, el icono y los documentos para importar el asistente en otro lugar. La copia no incluye claves, tokens, credenciales ni conversaciones; tendrás que volver a conectar esos secretos.

Iniciar una ejecución por webhook

Esta es la entrada HTTP pensada para conectarse desde otros sistemas. Crea una automatización de tipo Webhook en la interfaz y copia la URL y el token Bearer en ese momento: el token se muestra una sola vez.

POST https://studio.automators.work/api/hooks/{triggerId} acepta un cuerpo de texto o JSON de hasta 8 000 bytes. El contenido se añade como datos a la instrucción configurada en el disparador. Los enlaces existentes de assistant-studio.pages.dev siguen funcionando.

curl -X POST 'https://studio.automators.work/api/hooks/ID_DEL_DISPARADOR' \
  -H 'Authorization: Bearer TU_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: pedido-2548-v1' \
  --data '{"pedido":"2548","evento":"actualizado"}'

La respuesta 202 Accepted confirma que la ejecución quedó pendiente; no contiene la respuesta final del asistente:

{"runId":"ID_DE_EJECUCION","status":"pending"}

Idempotency-Key es opcional. Si repites una solicitud con la misma clave para el mismo disparador, recibes el runId anterior. Usa de 1 a 100 caracteres: letras, números, punto, guion o guion bajo. El webhook admite 20 ejecuciones al día; la cuenta admite 50 ejecuciones automáticas al día, incluidos horarios y pruebas manuales.

Recibir el resultado

Al crear el disparador, activa el correo o indica una URL HTTPS pública de respuesta. La URL recibe un POST con JSON cuando termina la ejecución:

{
  "runId": "ID_DE_EJECUCION",
  "assistantId": "ID_DEL_ASISTENTE",
  "triggerId": "ID_DEL_DISPARADOR",
  "name": "Nombre de la automatización",
  "status": "succeeded",
  "output": "Resultado del asistente",
  "error": ""
}

El encabezado X-Assistant-Studio-Signature lleva sha256= seguido del HMAC-SHA256 hexadecimal calculado sobre los bytes exactos del cuerpo con el secreto de respuesta mostrado al crear el disparador. Comprueba esa firma antes de procesar el mensaje y guarda el runId para evitar duplicados. Una entrega fallida puede reintentarse hasta tres veces.

También puedes consultar las últimas 30 ejecuciones en Automatizar → Historial; allí se distinguen el resultado y el estado de entrega de cada canal.

Convertir una API en herramientas

En Acciones puedes crear una herramienta HTTP manual o importar una definición OpenAPI 3 en YAML o JSON. El importador propone operaciones HTTPS GET, POST, PUT, PATCH y DELETE; seleccionas hasta cinco acciones por asistente.

Admite parámetros simples de ruta o consulta y cuerpos JSON planos. Las credenciales Bearer o de cabecera se guardan por separado, con nombre y vinculadas al origen HTTPS. Las escrituras se autorizan de forma individual para el chat del propietario y, por separado, para automatizaciones.

No se importan secretos desde el archivo OpenAPI. Los esquemas anidados, $ref, cuerpos multipart y servidores con variables no están admitidos en esta versión.

MCP y flujos n8n

En MCP puedes conectar un servidor remoto compatible con Streamable HTTP sobre HTTPS público. Se admiten servidores con token Bearer u OAuth; eliges qué herramientas de lectura tendrá disponibles el asistente. No se admiten servidores locales stdio.

Si ya tienes un flujo n8n, puedes usar un webhook de producción como acción POST del asistente. Define los datos de entrada que el modelo debe enviar, guarda la credencial del webhook por separado y prueba la acción. Esta conexión sirve para que el asistente llame al flujo; el webhook de entrada de Assistant Studio permite el recorrido inverso.

API de la aplicación

La interfaz usa rutas /api/* con la sesión del navegador en una cookie HTTP-only. Hoy no se emiten claves de API generales para administrar asistentes desde programas externos. Usa la interfaz para crear asistentes y disparadores; usa el webhook autenticado con Bearer para iniciar ejecuciones desde otro sistema.

Las rutas con sesión corresponden a la aplicación web y pueden cambiar junto con su interfaz. El webhook de entrada es el contrato de integración documentado para emisores externos.

Límites actuales

Estas cifras son límites del servicio, no una promesa de consumo incluido del proveedor de IA. El plan Creador cuesta USD 10 al mes o USD 100 al año; el registro nuevo requiere el primer pago antes de crear la cuenta.