Edita y gestiona tu flujo de trabajo en el diseñador

Note

Las características de este artículo están impulsadas por el arnés GitHub Copilot, que utiliza Copilot Credits para la facturación basada en el uso. Descubre más sobre los créditos de Copilot en Resumen de facturación para agentes impulsados por el arnés GitHub Copilot.

La facturación basada en el uso se aplica al uso, construcción, prueba y evaluación de agentes. Estas acciones pueden consumir Créditos de Copilot.

Los flujos de trabajo se crean y editan en el diseñador visual rediseñado en Copilot Studio. El diseñador proporciona un lienzo donde puedes crear o editar una automatización, añadir y eliminar acciones, comprobar errores y publicar tu flujo de trabajo sin salir del diseñador.

Mostrar un flujo de trabajo en el diseñador

Para mostrar un flujo de trabajo en el diseñador, abre Copilot Studio, selecciona Flujos de trabajo, selecciona el flujo de trabajo y luego selecciona la pestaña Compilar.

Screenshot del diseñador de Copilot Studio que muestra un flujo de trabajo publicado con un desencadenador y varias acciones.

Cambia cómo se muestra tu flujo de trabajo

Dependiendo del tamaño y la complejidad de tu flujo de trabajo, quizá quieras ajustar cómo se muestra para facilitar el trabajo con él. La barra de herramientas en la esquina inferior izquierda del lienzo controla la vista.

Captura de pantalla de la barra de herramientas de opciones de vista en el diseñador de Copilot Studio, con anotaciones numeradas de 1 a 6.

Leyenda:

  1. Acercar: Aumentar el tamaño del flujo de trabajo en el lienzo.
  2. Alejar: Disminuir el tamaño del flujo de trabajo en el lienzo.
  3. Ajustar vista: Cambiar el tamaño de la vista para que se ajuste a todo el flujo de trabajo en el lienzo.
  4. Ordenar: reorganiza el flujo de trabajo y las ramas para una vista de un extremo a otro más limpio.
  5. Diseño vertical: cambie a una vista de diseño vertical del flujo de trabajo.

Agregar y quitar acciones

  1. En la tarjeta después de la cual desea agregar la acción, seleccione Agregar un paso. Se abre el panel Agregar .

  2. En Añadir, empieza a escribir la acción que quieres que realice tu flujo de trabajo o el conector que quieres añadir, y luego selecciónlo de la lista. Dependiendo de lo que elija, es posible que deba proporcionar información adicional para completar la acción.

Si determinas que no es necesaria una acción, selecciona el icono Borrar en la esquina superior derecha de la acción.

Comprobar los parámetros del flujo de trabajo

Para ver los parámetros de un desencadenador o una acción en el flujo de trabajo, seleccione su tarjeta. El panel de configuración se abre en el lado derecho. A fin de introducir un valor para un parámetro, seleccione una opción de la lista desplegable o introduzca una expresión para establecer el valor dinámicamente.

Comprobación de errores

Los errores en las acciones de flujo de trabajo se indican en rojo. Para ver los detalles de un error en una acción, seleccione el error. Para listar todos los errores en todo el flujo de trabajo, abre el banner del centro de salud . Para ver todos los detalles de errores individuales, seleccione el error.

Important

No puedes publicar un flujo de trabajo si contiene errores. Debes corregir todos los errores antes de poder publicarlo.

Publicación del flujo de trabajo

Si el flujo de trabajo no tiene errores, puede publicarlo. En el menú superior del lienzo, selecciona Publicar.

Prueba del flujo de trabajo

Las pruebas te permiten verificar un paso o un flujo de trabajo completo sin salir del diseñador, usando ya sea datos reales de monta, valores que simulas tú mismo o resultados de una ejecución anterior.

Hay dos maneras de ejecutar una prueba:

Lo que quiere verificar Procedimiento de prueba Dónde encontrarla
Un solo paso de acción o IA de forma aislada Probar este nodo La pestaña de prueba dentro del panel lateral del nodo
El flujo de trabajo completo, de extremo a extremo Ejecutar prueba de flujo El botón Reproducir de la barra de comandos superior

Ambas superficies comparten la misma idea: proporcione entradas (reales o ficticias), ejecute y, a continuación, inspeccione la salida.

Prueba de un único nodo en un flujo de trabajo

Abra cualquier acción o nodo del flujo de trabajo y seleccione el botón Reproducir o Probar. Hay tres secciones:

  1. Ejecutar o restablecer la prueba: ejecuta el paso a petición o borra las entradas y salidas actuales.

    Captura de pantalla del panel de prueba del nodo que muestra las secciones Entradas, Configurar y Salida con el botón Probar resaltado.

  2. Valores de carga de una ejecución anterior: Un desplegable de las ejecuciones recientes de este flujo de trabajo. Al seleccionar uno, se extraen las salidas del paso anterior de esa ejecución hacia los campos de entrada siguientes.

  3. Entradas: un campo editable por paso ascendente genera las referencias de nodo. La insignia a la derecha de cada fila muestra el tipo esperado del campo (cadena, correo electrónico, fecha-hora, número, etc.).

  4. Salida: El resultado en tiempo real de la prueba más reciente, formateado para el tipo de nodo.

Entradas ficticias

De forma predeterminada, los campos de entrada están en blanco. Ustedes pueden:

  • Escriba cualquier valor directamente en un campo. El campo acepta el tipo que se muestra en el distintivo de la derecha.
  • Deje el campo vacío si su paso no depende de él.

Captura de pantalla del panel de prueba del nodo que muestra campos de entrada en blanco con distintivos de tipo a la derecha.

Tip

La pestaña Prueba enumera automáticamente las salidas del paso ascendente a las que hacen referencia las expresiones de este nodo. Si agrega un nuevo token al nodo, el campo correspondiente aparece la próxima vez que abra Test.

Carga de valores de una ejecución anterior

Captura de pantalla de la lista desplegable Cargar valores de ejecuciones anteriores, que muestra las ejecuciones pasadas con etiquetas de fecha, hora y estado.

Si tu flujo de trabajo se ejecutó antes, puedes reproducir datos reales en lugar de escribirlos:

  1. En la lista desplegable Cargar valores de la ejecución anterior , elija una ejecución.

  2. El diseñador captura las salidas del paso de ejecución y las proyecta a través del esquema de entrada del nodo. Los valores coincidentes se escriben en los campos de entrada.

  3. Edite cualquier campo después si desea ajustar el escenario.

La lista desplegable muestra las 10 ejecuciones más recientes de cualquier estado. Si una ejecución no incluye las salidas de uno de tus pasos ascendentes porque ese paso se saltó o no se tomó el camino, solo se llenan los campos disponibles. El resto sigue igual que estaba.

Si el flujo de trabajo no se ejecutaba antes, se muestra No hay ejecuciones anteriores disponibles y el desplegable queda oculto.

Ejecutar la prueba

Seleccione Ejecutar prueba. El botón muestra un estado ocupado mientras la llamada está en curso; en la sección Salida se muestra un spinner y, a continuación, el resultado o un error.

  • Restablecer la prueba borra tanto las entradas como la última salida.
  • La prueba ejecuta el nodo de forma aislada con la API del conector. La prueba no activa el resto del flujo de trabajo.

Prueba todo el flujo de trabajo

En la barra de comandos superior, seleccione el botón Reproducir (Prueba). Prueba tu flujo de trabajo de principio a fin contra el tiempo de ejecución en vivo.

Antes de que se inicie la ejecución, el diseñador:

  1. Guarda y publica el flujo de trabajo si tienes cambios desguardados, o si es la primera vez.
  2. Instala las nuevas conexiones en la primera ejecución.
  3. Desencadena la ejecución. La ruta depende del tipo de desencadenador.
Tipo de desencadenador ¿Qué ocurre al seleccionar Probar?
Solicitud manual/HTTP Se abre un diálogo para que introduzcas las entradas de disparo, y el flujo de trabajo se ejecuta inmediatamente.
Ventana deslizante/periodicidad/sondeo O bien el horario comienza y la primera ejecución se inicia automáticamente, o, si ya está instalado, el flujo de trabajo se ejecuta una vez.
Evento de conector (por ejemplo, cuando llega un correo electrónico) El flujo de trabajo se publica y espera. Puedes ver Esperando el desencadenante.... Realiza la acción en el sistema fuente para activar la secuencia.
Webhook HTTP El flujo de trabajo se publica; Haz que se active desde el sistema externo como normalmente harías.

Entradas ficticias (desencadenador manual)

Para disparadores manuales, el cuadro de diálogo Introducir entradas manuales muestra un campo por cada entrada que definiste en el disparador:

  • Texto/número/email/fecha: control de ingreso adecuado.
  • Boolean: interruptor de palanca.
  • Opción única (enumeración): lista desplegable.
  • Selección múltiple: lista desplegable.
  • Archivo: Selector de archivos. El contenido se sube como parte de la partida.
  • Objeto o matriz: área de texto de varias líneas donde puede pegar JSON.

Selecciona Ejecutar para iniciar el flujo de trabajo con esas entradas, o Cancelar para descartar sin ejecutar. Los campos obligatorios se marcan con un asterisco. Si faltan valores o no son válidos, aparecen mensajes de validación en línea y la ejecución se bloquea hasta que se corrijan.

El diálogo aparece cada vez que seleccionas Probar. Los valores no se guardan entre ejecuciones, por lo que puede probar rápidamente diferentes escenarios.

Supervisar la ejecución

Una vez que una ejecución está en curso:

  • La barra de comandos muestra un botón Cancelar mientras la ejecución está activa.
  • El panel de Actividad a la derecha muestra la partida actual en la parte superior con una insignia de estado: En curso, Esperando, Exitoso,Fallido o Cancelado. Seleccione cualquier ejecución para abrirla en el lienzo e inspeccionar las entradas y salidas de cada paso.

Seleccione ejecuciones anteriores

El panel de Actividades también sirve como historial de ejecuciones de tu flujo de trabajo:

  • Filtra por Todos/Sucedidos/Fallidos/En Ejecución usando el desplegable en la parte superior.
  • Seleccione Actualizar para volver a recargar la lista.
  • Seleccione Cargar más en la parte inferior para volver a la página.
  • Al seleccionar una ejecución, se carga en el lienzo, donde cada nodo muestra las entradas que recibió y las salidas que generó para esa ejecución. Los datos son los mismos que los que usa la pestaña Prueba de nivel de nodo al elegir una ejecución en su lista desplegable.

Cuándo usar cada tipo de prueba

  • ¿Iterar con un solo paso de IA o acción de conector? Usa Prueba este nodo. Es más rápido, no publica y te permite simular solo los valores aguas arriba que importan.
  • ¿Validar comportamientos de extremo a extremo o lógica de disparos? Usa Run flow test. Ejercita todo el gráfico contra el tiempo de ejecución real.
  • ¿Reproduciendo un problema de producción? Abre la ejecución fallida desde el panel de Actividad, luego abre el nodo fallido y usa valores de carga de la ejecución anterior en su pestaña de Test para reproducir los datos exactos aguas arriba en la acción.