Request information from human review in agent flows

Human input, review, and action are essential to ensure that automations and AI workflows run effectively and maintain high quality. The request information (RFI) action in agent flows provides a streamlined way to incorporate human oversight into automated processes.

Access request information

The request information action is available in agent flows. Learn more about agent flows in the Agent flows overview.

What is the request information action?

Request information is an action that lets you:

1. Pause execution.
2. Collect input from designated human reviewers before proceeding with subsequent steps.
3. Use input from human reviewers in subsequent steps.

Common use cases for request information

The request information action addresses critical business needs across various industries. Here are a few examples:

• Insurance claims processing: When automated claim review identifies missing documentation or requires damage assessment details, the RFI action can request specific information from field adjusters, such as repair estimates, photo documentation, or on-site inspection results.
• Financial services compliance: During loan applications or account reviews, flows can pause to request more verification documents from compliance officers, such as income verification, credit assessments, or regulatory approvals.
• Supply chain quality control: Manufacturing processes can request inspection reports from quality assurance teams when automated systems detect potential defects or when supplier certifications need human verification.
• Legal document review: Contract approval flows can pause to request legal counsel input on specific clauses, risk assessments, or compliance requirements that require professional judgment.
• IT security incident response: Security flows can automatically request more investigation details from cybersecurity analysts when threat detection systems identify suspicious activities requiring expert analysis.

Set up request information in your agent flow

There are a few steps to set up and test the request information action in your agent flow.

Add request information in your agent flow

If you don't have an existing agent flow for this action, start by creating one:

1. Log into Copilot Studio at copilotstudio.microsoft.com.

2. Select Flows from the left navigation to access the Workflows page.

3. Select New agent flow.

4. Add a trigger to your agent flow.

If you already have an agent flow and want to add this action, open it in the flow designer and continue with the following steps:

1. In the flow designer, add a new Request for information action at the location where you want to add the request for information action:

   • In agent flows, select Insert a new action where you want to add the action, and select Request for information under Human review.

2. On the canvas, select your Request for information node to open the configuration pane and configure the following required fields:

   • Title: The subject line of the email that is sent with the request. Example: "Missing Information on Claim with ID: ABC123"
   • Message: The message or note that accompanies the request for information. Example: "This request is being sent to you because... Provide this information at your earliest convenience."
   • Assigned to: The email addresses of individuals who receive the request. You can enter multiple emails, however, the response from the first person to respond is used.

   Important

   • The response from the first person to respond is used in the flow. Subsequent responses aren't processed.
   • All requests are currently sent via Outlook only. More platforms might be added in the future.
   • Requests can't be sent to users outside of your tenant.

3. Select Add an input.

4. Add your first input by selecting one of the available input types.

5. Five input types are currently supported:

   • Text (string)
   • Yes/No (Boolean)
   • Email (email address)
   • Number (integer)
   • Date (date)

   

   Inputs offer flexibility with options for multi-select, single-select, and required fields. More input options are covered later in this article.

6. Give the input a descriptive name.

7. Add more inputs as needed by selecting Add an input.

Here's an example of a fully configured request information action in an agent flow:

Use parameters from request information in other actions

Every input that you specify in your request for information action produces a parameter that can be used in subsequent actions.

For example, in the previously shown configuration, all the parameters such as Date, Summary, Damage amt., and others become available as dynamic content that can be passed as input into subsequent actions.

In the example that follows, we use the parameters from the request for information action in a subsequent AI approval action:

At runtime, when the human responds to the request, the parameters are automatically populated with the values from their submission.

Run and test request information in your agent flow

You now have a request for information action added to your agent flow. Now it's time to test it. Here's a snippet of a claim approval flow with the request for information action highlighted. We use this flow for demonstration purposes.

To test run your agent flow or workflow with the request information action, follow these steps:

1. Save and publish the agent flow.

2. Select Test to test run your flow.

   The flow runs. When the flow reaches the request information action, it pauses execution and sends the request to the assigned humans via email through Outlook.

   The following images show the relationship between the request configurations in the agent flow designer and the email received by the reviewer. Notice that the inputs specified in the agent flow designer in the first image correspond to the inputs being requested in the email as seen in the second image.

   

   

3. Within Outlook, the reviewer enters the responses to each of these fields and then selects Submit.

   After the reviewer submits the responses, the flow resumes execution and continues with the remaining actions. As explained previously, the response data can be used in subsequent actions throughout the flow.

   Note

   Since requests are sent via Outlook, requests could be sent to users who are outside of the environment in which the agent flow was built.

More on inputs

You have some flexibility in configuring your inputs. Here are some ways you can make inputs more flexible:

• Make some inputs optional (all input types): When you send requests for information, you might want to make certain fields optional. In the designer, select the three dots (…) beside the input you added and select Make the field optional. When this request is sent, that input is optional for the assignee.

  

• Placeholder text (all input types): You can customize the placeholder text that the assignee sees when they receive a request. Use this to provide additional information or hints on how the field should be completed.

  To do so in the designer, select the field beside the name field of the input and customize the placeholder text. When the assignee receives the request, they see the corresponding placeholder text in each field. For example, in the image that follows, they would see: "Please enter the date on which you conducted the assessment."

  

  

• Single-select options (text inputs): For text inputs, you can provide predefined options to assignees. These options can be configured as single-select, requiring the assignee to choose one option from the list.

  In the designer, select the three dots (…) beside the text input, and then add a dropdown of options.

  

  Add the options you want the assignee to choose from.

  

  When the request is sent, the assignee can select one of the options from the list.

• Multi-select options (text inputs): For text inputs, you can also provide predefined options that allow assignees to select multiple choices. Multi-select lets the assignee choose more than one option from the available list.

  In the designer, select the three dots (…) beside the text input, and then add a multi-select list of options.

  

Known issues

Occasionally, a request information action might return outputs wrapped in double braces ({{ }}) when you reference parameters in your flow. To avoid this issue, ensure that input names are configured without spaces.