Orqueste utilizando asistentes de IA

El asistente de inteligencia artificial de Braidrun no es una barra de herramientas complementaria: comprende directamente YAML, DAG y el estado de ejecución de la página actual, puede cambiar el flujo de trabajo, activar la ejecución, instalar habilidades y cambiar de idioma. A continuación te explicamos cómo empezar y utilizarlo a diario.

Donde abrir

• Botón flotante en la esquina inferior derecha (disponible en todas las páginas principales)
• Teclas de acceso directoAlt + G

Dentro del cajón hay un panel de conversación en streaming que admite Markdown/resaltado de código (12 idiomas) y comandos de barra diagonal.

¿Qué se puede hacer?

• Crear/modificar/verificar/ejecutar flujo de trabajo
• Crear, habilitar y desactivar horarios
• Actualizar o instalar habilidad
• Cambiar idioma de interfaz
• Responda preguntas sistémicas como "¿Qué admite este sistema/Cómo escribir una determinada configuración/Cómo utilizar una determinada API?"

Comando de barra diagonal

/execute               # run the current workflow (alias: /run)
/validate              # validate YAML without running
/export                # download workflow YAML
/new                   # start a fresh workflow
/undo                  # roll back the last assistant change (up to 10)
/help                  # list all slash commands

Empiece el mensaje con «/» en el cuadro de entrada para activarlo. Los comandos slash tienen prioridad sobre el texto libre y, además, llaman directamente a la interfaz de la plataforma sin pasar por el modelo — no consumen la cuota diaria del asistente de IA. En páginas como el editor o la lista de workflows, aparecen además los botones de acceso rápido correspondientes encima del cuadro de entrada.

Vista previa de diferencias y deshacer pila

Todos los cambios en recursos como flujo de trabajo/programación/credencial le darán primero una vista previa de diferencias:

• Los nuevos pasos/campos están resaltados en verde
• Los campos modificados están marcados en amarillo.
• Los pasos/campos eliminados están resaltados en rojo

Después de la confirmación, puede usar /undo para revertir en cualquier momento, conservando hasta las últimas 10 modificaciones. La sesión en sí también se puede exportar a Markdown con un solo clic.

Interacción con el editor

• Cuando pide al asistente que construya / modifique un workflow en el editor, el lienzo va mostrando cada cambio en el orden de las operaciones: los nodos y las conexiones nuevos aparecen paso a paso y usted ve cómo va creciendo el workflow; los cambios siguen requiriendo que pulse Guardar para persistirse.
• El panel de problemas de diagnóstico del editor puede «pasar a la IA para su reparación» un problema concreto o todos; el panel de propiedades de un paso también tiene un acceso para abrir el asistente directamente con el contexto del paso actual — sin necesidad de copiar y pegar el YAML usted mismo.
• Cada paso que modifica el asistente también entra en el propio historial de deshacer / rehacer del editor; con Ctrl / Cmd + Z se puede retroceder paso a paso.

La explicación completa de cada área del editor está en Editor visual.

Preparación: configura tu asistente de IA

Ir antes de usarlo por primera vez. Configuración de la cuenta → Asistente de IA Abra y seleccione un proveedor de modelo (por ejemplo, OpenRouter, OpenAI, Anthropic, DeepSeek) o configure el modelo de suscripción en el área Claude Code/Codex. El verdadero secreto está puesto en Gestión de credenciales → Mis credenciales Mantenimiento, se resolverá automáticamente según la cuenta actual cuando se ejecute. Los administradores no necesitan preconfigurar el asistente de IA para los usuarios habituales.

Código Claude / modelo Codex

Si quieres que el asistente de IA invoque Claude Code o Codex, elige el método de autenticación en Configuración de la cuenta → Asistente de IA → Claude Code / Codex:

• Código Claude: puede utilizar la clave API Anthropic o el token de suscripción Claude (provider=claude_code_oauth).
• Codex: puede usar la clave API de OpenAI o puede usar Codex para suscribirse a auth.json (provider=codex_subscription).
• El modo de suscripción no escribe token/auth.json en la configuración del asistente AI; solo lo lee desde sus credenciales personales o de equipo.

Base de conocimientos de documentación

Para que el asistente de IA responda una pregunta sobre la documentación del sistema (por ejemplo, "¿Cuál es el tiempo de espera predeterminado para la aprobación_manual"), vaya a Configuración → Almacenamiento de persistencia de plataforma → Base de conocimientos de documentación de AI Assistant Confirme que esté habilitado. Las guías integradas, los documentos maestros del proyecto y los documentos de referencia seleccionados están indexados de forma predeterminada y la compilación automática al inicio está habilitada de forma predeterminada; puede ver el estado y hacer clic manualmente en "Reconstruir base de conocimientos" en la misma página.

Transmisión de razonamiento del "proceso de pensamiento"

Cuando el modelo seleccionado admite el razonamiento (Claude Sonnet 4.5 / 4.6 / 4.7, DeepSeek-R1, serie GPT-o1 / o3, Gemini Thinking, etc.), el cajón del asistente de IA mostrará primero una tarjeta doblada del "Proceso de pensamiento del asistente de IA". El modelo primero transmite el resumen del razonamiento aquí y luego genera la respuesta final:

• El cliente contrae el evento Reasoning_delta y no actualizará la pantalla (evitando volver a renderizar cada fotograma).
• El razonamiento completo solo se presenta con la subcategoría de pensamiento cuando razonamiento_completo
• Haga clic en la tarjeta de pensamiento para expandir/contraer; está colapsado por defecto para evitar ocupar el campo de visión
• El contenido del pensamiento también se registrará en la pila de deshacer junto con /undo para facilitar la revisión.

Los modelos que no admitan el razonamiento no mostrarán tarjetas adicionales y se comportarán como antes.

Memoria a largo plazo

El asistente de IA es independiente por sesión por defecto. Si desea que "recuerde" sus preferencias ("Me gustan las respuestas en chino + descuento breve", "Mi flujo de trabajo ASA siempre se ejecuta temprano en la mañana"), puede activar la Memoria a largo plazo en la configuración del Asistente AI:

• Después de habilitarlo, los mensajes del usuario y las respuestas del asistente se vectorizarán y almacenarán en el espacio de nombres ltm:<user_id>:* entre sesiones.
• Cuando comience la siguiente ronda de diálogo, los recuerdos más relevantes se recuperarán automáticamente como inyección de contexto.
• Hay un botón "Borrar memoria a largo plazo" en la esquina superior derecha de la barra lateral del Asistente AI. POST /api/global-agent/memory/clear borra todos los espacios de nombres del usuario actual con un clic; Adecuado para su uso al cambiar de dispositivo/cambiar de equipo.

Consejos

• Si desea que la IA genere YAML: pídale explícitamente que genere YAML de caso de serpiente.
• Flujo de rama: dar prioridad a generar la estructura de clasificador + condición
• Gran cambio: use lenguaje natural para describir la intención y luego divídala en diferencias de varios pasos
• combinar depurador : Una vez completada la modificación de la IA, habilite la depuración y ejecute en seco el flujo de trabajo antes de conectarse.
• Al seleccionar un modelo que admita el razonamiento, puede ver directamente el "proceso de pensamiento" y el diseño del mensaje de depuración es muy útil.