Solución de problemas

Organizado por "Síntomas que ves". Localice rápidamente el más cercano y siga "Cómo reparar". Si no se puede solucionar, vaya a "Preguntas frecuentes" o envíe una orden de trabajo.

Relacionado con la ejecución

La Ejecución queda PENDIENTE y permanece EN EJECUCIÓN.

Comprueba primero:

1. Revise si en la parte superior del «Historial de ejecuciones» aparece el aviso «se alcanzó el límite de concurrencia». Free permite 1 concurrente / Pro 5 / Team 15: ¿la cantidad de ejecuciones simultáneas ha llegado al límite?
2. Compruebe si el paso manual_approval de este flujo de trabajo está bloqueado al principio.
3. Déjelo esperar otros 30 segundos, un instante ocasional. La orden de trabajo está PENDIENTE después de más de 2 minutos.

Error de ejecución: credential_not_found

Cómo solucionarlo:

1. Mire el nombre de la credencial que aparece en error_message.
2. Centro de credenciales abierto: ¿existe realmente una credencial con este nombre? Las mayúsculas, los guiones bajos y los guiones deben ser coherentes.
3. ¿Ha creado credenciales en el "Espacio de nombres del equipo" pero actualmente tiene la función de Visor? El espectador no puede hacer referencia a las credenciales.
4. Hay algo en la lista pero no se ha analizado: cierre la sesión y vuelva a iniciarla para actualizar los permisos.

Error de ejecución: rate_limit_exceeded

Razón:Se activa su límite actual de proveedor de LLM o el de la plataforma.

Cómo solucionarlo:

1. Agregue una estrategia de reintento al paso fallido:

- id: call_llm
  type: single
  agent: writer
  retry:
    max_attempts: 3
    backoff: exponential
    initial_delay_ms: 2000
    retry_on: [rate_limit, http_5xx]

2. Si a menudo califica_limit, la solución fundamental es actualizar BYOK el nivel de la cuenta del proveedor.
3. Cuando ejecute muchas tareas por lotes, utilice sub_workflow + max_parallel para controlar la simultaneidad.

Error de ejecución: tiempo de espera

Razón:Un solo paso excede su valor de tiempo de espera o toda la ejecución excede el tiempo de espera a nivel de flujo de trabajo.

Cómo solucionarlo:

• code step: agregue explícitamente el campo timeout al step (en segundos, 30 por defecto).
• Paso LLM: puede ser que la generación del modelo sea demasiado larga; reduzca max_tokens o utilice un modelo más rápido.
• Todo el flujo de trabajo es lento: agregue un campo de tiempo de espera en la parte superior (en segundos, el valor predeterminado es 3600).

La Salida del agente está vacía/irrazonable

Comprueba primero:

1. Detalles de ejecución → Haga clic en este paso → Mire el "Historial de llamadas de herramienta del agente" para ver si se le dirigió a la herramienta incorrecta.
2. Compruebe si la variable de entrada está vacía: ¿la condición omite el paso ascendente?
3. Ajustar la temperatura: 0–0,3 para tareas de razonamiento/clasificación; 0,6–0,9 para creatividad.
4. descripción de la tarea más ejemplos más específicos de algunos intentos.
5. Intente cambiar a un modelo más potente (claude-opus-4-7/gpt-5).

El Paso del código informa permiso denegado o error de red.

El paso del código se ejecuta en un entorno limitado de aislamiento, con restricciones:

• El sistema de archivos es de sólo lectura; sólo se puede escribir en /tmp;
• La red sólo puede salir pero no entrar (no puede monitorear el puerto);
• CPU/memoria/tiempo de ejecución están limitados.

Cómo solucionarlo:permiso denegado generalmente significa que está intentando escribir en una ruta distinta a /tmp - /tmp/algo. La mayoría de los errores de red se deben a que el sandbox bloquea el host de destino (la plataforma tiene una lista blanca de salida). Puede enviar una orden de trabajo para agregar a la lista blanca.

Guardado y edición relacionados

Mensaje "YAML no es coherente con DAG" al guardar

Significa que la regla de ida y vuelta no se cumple después de cambiar manualmente el YAML. Razones comunes:

• Nombre del campo camelCase usado (debe ser Snake_case)
• Hace referencia a un ajuste preestablecido o agente eliminado
• depende_on apunta a una identificación de paso que no existe

Al hacer clic en el botón "Verificar" obtendrá el número de línea exacto; corríjalo según la ubicación del error.

El Editor no se puede abrir/sigue dando vueltas en círculos

1. Actualizarlo. Generalmente transitorio.
2. Mire la barra de estado que muestra "xxx está editando": otra persona mantiene el bloqueo de edición. Se liberará automáticamente después de 5 minutos sin operación o se comunicará con la otra parte.
3. El administrador puede "forzar el desbloqueo" en la configuración del equipo.
4. Borre la memoria caché del navegador/cambie el navegador para probar.

La Diferencia proporcionada por el asistente de IA no se pudo verificar después de la aplicación.

Ctrl / Cmd + Z para revertir: el editor admite deshacer en varios niveles. Luego pegue el mensaje de error junto con el YAML original al asistente y este lo corregirá.

Programación/Webhook relacionado

cron No Se disparó en el momento

1. ¿La "próxima hora de activación" en la página de detalles del cronograma es consistente con las expectativas? La falta de coincidencia de zona horaria es la causa más común.
2. ¿Existe algún registro del "Historial de los últimos 10 activadores"? De lo contrario, es posible que el flujo de trabajo se haya archivado o eliminado.
3. Observe el estado del flujo de trabajo: ¿está en pausa? El programa de pausa todavía cuenta, pero en realidad no se activará.
4. Verificar manualmente el flujo de trabajo con el botón "Activar una vez ahora" está bien.

Webhook El Gatillo regresa 401 / 403

1. Método API Key: ¿la key que va en el header Authorization: Bearer o X-API-Key es correcta? ¿Ha caducado la key? ¿Tiene el ámbito WEBHOOK_TRIGGER?
2. HMAC 兼容方式：你是否用 HMAC-SHA256 对 raw body 算了签名，放 X-Webhook-Signature 头？格式是 sha256=<hex>。注意：绑定了 API Key 的 webhook 不再接受 HMAC 签名。
3. ¿El webhook ID en la ruta de la URL está escrito correctamente? ¿Se ha eliminado el workflow correspondiente?

Webhook Dispara 200 pero la ejecución no comienza

200 sólo significa "solicitud aceptada", la ejecución puede rechazarse:

• Si el flujo de trabajo está en pausa;
• Si este paquete alcanza la cuota de simultaneidad/programación;
• La verificación falló cuando el cuerpo se asignó a variables (faltan campos obligatorios/el tipo es incorrecto).

Registro de activación de webhook: en la pestaña "Historial" de la página de detalles de programación, puede ver los detalles del análisis de la plataforma después de recibir la solicitud.

Relacionado con la aprobación

manual_approval nunca envía notificaciones

1. ¿La página "Configuración de notificaciones" está vinculada a algún canal de Slack/Feishu/Correo electrónico?
2. Registro de auditoría → Filtro de aprobación_notificar_failed: vea por qué no se puede enviar la notificación (¿URL del webhook no válida? ¿Rebote de correo electrónico?).
3. Cuando la lista de aprobadores esté vacía, notificará a "todos los administradores y superiores" de forma predeterminada. ¿Es su cuenta una de ellos?

Lo Aprobé pero el flujo de trabajo no continuó

El flujo de trabajo posterior a la aprobación debe continuar en 10 segundos. No continuó por más de 1 minuto:

1. Actualiza la página de detalles de ejecución. ¿Ya está FUNCIONANDO?
2. El sistema está ocupado y puede estar en cola durante 30 segundos, etc.
3. Generar una orden de trabajo después de más de 5 minutos.

Relacionado con el equipo/permiso

No Puedo ver el flujo de trabajo después de cambiar de equipo

Los flujos de trabajo están aislados por equipo; no se muestran entre equipos. Asegúrate de haber seleccionado el equipo correcto (desplegando hacia abajo en la esquina superior derecha). Si cambia de "Individual" a "Equipo", deberá volver a crear el flujo de trabajo en el equipo o pasar de individual.

Los colegas dicen que no tienen permiso para cambiar un determinado flujo de trabajo

¿Es un espectador en este equipo? El visor es de sólo lectura. Simplemente actualícelo de Administrador a Editor.

No Soy el propietario, pero quiero transferir el flujo de trabajo que creé

"Mover al equipo" requiere que seas editor o superior en el equipo de destino. Únase usted mismo al equipo objetivo.

Pagar/facturar

Error en el cargo con tarjeta de crédito

1. Página de facturación → "Reintentar débito". Después de 3 fallas, el paquete se degradará temporalmente a Gratis; se restaurará automáticamente siempre que deduzcas dinero exitosamente dentro de los 14 días.
2. Las tarjetas chinas pueden estar controladas por riesgos mediante Stripe; utilice Alipay/WeChat Pay.

El Título de la factura es incorrecto.

Puede cambiar los datos de facturación en la página de facturación antes de la emisión del mes siguiente. Para las facturas ya emitidas, es necesario escribir a billing@braidrun.com para solicitar su anulación y reemisión.

Intenté todo pero todavía no funciona.

1. "Ayuda" en la esquina inferior derecha → Enviar una orden de trabajo. Adjunte automáticamente el contexto del navegador + ID de ejecución más reciente.
2. Plan Empresarial → Póngase en contacto directamente con el CSM dedicado.