Implementación de un patrón de solicitud para información

Completados

Algunos flujos de trabajo no pueden finalizar un paso hasta que alguien que no sea el solicitante proporciona un valor que falta, como un código de proyecto que el empleado no conoce. En esta unidad, explorará cómo solicitar ese valor de una persona designada dentro de un flujo de trabajo de Copilot Studio y usará la respuesta en un paso de flujo de trabajo posterior.

Decidir quién proporciona el valor que falta

Supongamos que el flujo de trabajo de reembolso comprueba el registro de gastos y encuentra que su código de proyecto está en blanco. El código procede del propietario del proyecto, que mantiene los registros del proyecto. En esa situación, una solicitud del lado del flujo de trabajo llega a la persona que puede proporcionar el valor antes de que el flujo de trabajo lo use. La decisión del empleado de enviar la notificación responde a una pregunta diferente.

Si el empleado ya conoce el código y está autorizado para suministrarlo, el agente puede pedir el código durante la conversación y pasarlo como entrada cuando llama al flujo de trabajo. Si el propietario del proyecto contiene el valor autoritativo, el flujo de trabajo puede solicitarlo después de identificar el campo que falta. Utiliza al responsable de la respuesta y el momento en que se detecta la carencia para decidir dónde preguntar. Una solicitud del lado del flujo de trabajo es especialmente útil cuando la necesidad de un valor depende de los datos que el flujo de trabajo lee o calcula después de que se inicie.

En este ejemplo, el flujo de trabajo verifica el registro de gastos antes de la etapa de reembolso. Si el registro tiene un código de proyecto utilizable, el flujo de trabajo no necesita una solicitud para ese campo. Si falta el código y el propietario del proyecto lo proporciona, coloque la solicitud antes del paso que necesita el código. Esta disposición mantiene la solicitud de intervención humana vinculada a la ausencia de un valor concreto, en lugar de añadir una pausa para revisión a cada afirmación.

Configuración de la solicitud para el propietario del proyecto

En los flujos de trabajo de Copilot Studio en el harness de GitHub Copilot, se agrega la acción Solicitud de información seleccionando Agregar un paso y buscando Revisión humana. Coloque la acción en el punto donde el flujo de trabajo necesita una persona para proporcionar información. La acción pone en pausa el flujo de trabajo hasta recibir la respuesta de la persona asignada, y la respuesta queda disponible para los pasos posteriores del flujo de trabajo. Para obtener la acción y la configuración documentadas, consulte Solicitar información de revisión humana en flujos de trabajo.

La acción requiere tres campos. Asigne a cada campo un trabajo distinto en el ejemplo de reembolso:

  • Título: identifique la solicitud en la línea de asunto del correo electrónico, como Project code for reimbursement 47821. Un título específico ayuda al propietario a reconocer qué reclamación requiere atención.
  • Mensaje: Explique lo que el propietario necesita proporcionar y por qué. Incluya el identificador del gasto pertinente de un paso anterior del flujo de trabajo para que el responsable pueda asociar la solicitud con la reclamación. No asuma que el propietario ve la conversación del empleado con el agente.
  • Asignado a: escriba la dirección de correo electrónico del propietario del proyecto. Si más de un propietario elegible puede responder, la acción puede dirigirse a varias personas. Elija los destinatarios basados en quién tiene autoridad para proporcionar el valor, no solo quién está disponible.

Para esta acción, las solicitudes se envían a través de Outlook a las personas de su organización. No puede usar la acción para enviar una solicitud al propietario de un proyecto externo. Con varios asignados, el flujo de trabajo usa la primera respuesta y no procesa las respuestas posteriores. Asignar varias personas, por lo tanto, solo funciona si alguno de ellos puede proporcionar el código autoritativo.

El título y el mensaje explican la solicitud, mientras que el campo de entrada define el valor que devuelve el receptor. Mantenga esa distinción al redactar el mensaje: Una nota que indica "enviarme el código del proyecto" no crea una entrada de código de proyecto que el flujo de trabajo puede usar. Defina la entrada explícitamente para que la respuesta se convierta en datos para la siguiente acción.

Dar forma a la respuesta como datos de flujo de trabajo

Para el reembolso, agregue una entrada de texto denominada ProjectCode. Use el texto del marcador de posición para describir la respuesta esperada, como Enter the project code for this claim. Mantenga ProjectCode necesario, ya que el flujo de trabajo no puede continuar sin el código. Para realizar una entrada opcional, seleccione Convertir el campo opcional cuando un paso posterior pueda funcionar sin su respuesta. Por ejemplo, una nota opcional del propietario puede proporcionar contexto sin reemplazar el código necesario.

La acción ofrece cinco tipos de entrada. Haga coincidir el tipo con la respuesta que necesita el flujo de trabajo, no con el rol de la persona que responde:

Tipo de entrada Valor que se recopilará en un proceso de gastos
Text Un código de proyecto o una explicación del propietario. Una entrada de texto también puede ofrecer opciones de selección única o de selección múltiple para un conjunto definido de valores.
Sí/No Decisión sobre si el flujo de trabajo puede continuar. Un paso posterior del flujo de trabajo puede ramificarse según la respuesta «Sí» o «No» del revisor.
Correo electrónico Una dirección de correo electrónico para un contacto de gastos.
Número Valor entero, como una referencia de número entero que usa el proceso.
Date Una fecha relevante para la reclamación.

El código del proyecto sigue siendo una entrada de texto incluso si contiene dígitos, ya que el valor identifica un proyecto en lugar de medir una cantidad. Si un flujo de trabajo necesita una opción guiada en lugar de texto libre, proporcione opciones en una entrada de texto y asegúrese de que las opciones corresponden a los valores que controla el flujo de trabajo. La pregunta que el propietario responde a continuación coincide con los datos que espera el paso posterior.

Use nombres de entrada sin espacios, como ProjectCode. Un problema conocido afecta a los nombres de entrada que contienen espacios: la respuesta puede aparecer ocasionalmente encapsulada {{ }} cuando se usa el valor más adelante.

Uso de la respuesta en pasos de flujo de trabajo posteriores

Una vez que el propietario del proyecto responda, ProjectCode está disponible como contenido dinámico en las acciones de flujo de trabajo posteriores. En el ejemplo de reembolso, un paso posterior usa ese valor donde necesita el código del proyecto. Puede solicitar más de un valor en la misma solicitud y usar las respuestas correspondientes por separado. Mantener una solicitud centrada en los valores que puede proporcionar la persona asignada: agregar preguntas no relacionadas hace que sea más difícil saber qué respuesta necesita un paso posterior.

Si un agente invoca este flujo de trabajo como herramienta, el flujo de trabajo debe seguir alcanzando Responder al agente en menos de 100 segundos. Una solicitud realizada antes de esa acción solo se ajusta cuando el propietario puede responder dentro de esa ventana.

Reflect: En un proceso que gestionas, ¿qué valor debe aportar una persona distinta de quien lo inicia a un flujo de trabajo y qué tipo de entrada captura ese valor?