Capture
Introduction
The Capture Step in Voiceflow is a powerful tool that allows you to collect user input during a conversation. Whether you want to capture the entire user reply or extract specific entities, the Capture Step provides flexibility and control over how you gather and handle user responses.
This guide will walk you through the features of the Capture Step, including how to:
-
Capture the entire user reply and save it to a variable.
-
Extract specific entities from the user's input.
-
Configure options like No Reply and Listen for Other Triggers.
-
Set up Automatic Reprompts, Rules, and Exit Scenarios to enhance the user experience.
Accessing the Capture Step
- Open the Step Toolbar: In your Voiceflow project, locate the step toolbar on the left side of the canvas.
- Drag the Capture Step onto the Canvas: Hover over Listen and drag the Capture step icon onto your workspace where you want to collect user input.
Capturing the Entire User Reply
Overview
When you want to capture exactly what the user says and store it for later use, you can configure the Capture Step to save the entire user reply to a variable.
Configuring to Capture Entire User Reply
-
Select Capture Mode: In the Capture Step editor, you'll see a toggle to choose between Entities and Entire User Reply. Select Entire User Reply.
-
Set the Variable: Specify the variable where you want to store the user's reply. This variable can be used later in your conversation flow to personalize responses or process the input.
Options and Toggles
The Capture Step offers additional options to control the user's experience:
1. No Reply
- Purpose: Handles situations where the user doesn't respond within a certain timeframe.
- How to Enable:
- Toggle No Reply to ON.
- Set Timeout Duration: Define the time (in seconds) the system should wait for a response before considering it a no-reply.
- Customize Reprompt Message: Provide a message that will be sent to the user if they don't reply in time (e.g., "Are you still there?").
2. Listen for Other Triggers
- Purpose: Allows the agent to recognize and respond to intents that are outside the scope of the current Capture Step.
- How to Enable:
- Toggle Listen for Other Triggers to ON.
- Behavior:
- ON: The agent listens for other intents while waiting for the user's reply. If the user says something that matches another intent, the agent will trigger that intent.
- OFF: The agent focuses solely on capturing the user's input in this step. It won't trigger other intents until after the capture is complete.
Capturing Entities
Overview
When you need to extract specific pieces of information (entities) from the user's input, you can configure the Capture Step to target those entities directly.
Configuring to Capture Entities
-
Select Capture Mode: In the Capture Step editor, toggle to Entities.
-
Add Entities:
- Click the "+" Button: Beside the Entities label, click the "+" button to add entities you want to capture.
- Select Existing Entities: Choose from the list of entities you've already defined in your Entity CMS.
- Create New Entity:
- If the entity you need isn't listed, select Create New Entity at the bottom of the dropdown.
- Define the New Entity: Provide a name and configure the entity as needed.
-
Specify Multiple Entities:
- You can add one or multiple entities to capture in this step.
- The system will attempt to extract all specified entities from the user's input.
Options and Toggles
Similar to capturing the entire user reply, you have additional options:
1. No Reply
- Functions the same as described earlier, prompting the user if they don't respond within the set timeframe.
2. Listen for Other Triggers
- Functions the same as described earlier, allowing or disallowing the agent to respond to other intents during this capture.
3. Automatically Reprompt
- Purpose: Enables the system to automatically generate personalized reprompts if the user's input doesn't fulfill the entity requirements.
- How to Enable:
- Toggle Automatically Reprompt to ON.
- Configuration:
- Model Settings:
- Temperature: Controls the randomness of the AI's responses. A lower temperature means more deterministic responses.
- Max Tokens: Sets the maximum length of the AI's response.
- System Prompt: Provide context or guidelines to the AI for generating reprompts (e.g., "Please ask the user for missing information politely.").
- Model Settings:
Rules and Exit Scenarios
To enhance control over how entities are captured and how the conversation proceeds, you can define Rules and Exit Scenarios for the entity collection in your Capture Step.
1. Rules
Purpose
- Validate User Input: Specify conditions that the user's input must meet for the entities to be considered successfully captured.
- Guide the AI: Provide instructions to the LLM to ensure accurate extraction of entities.
How to Add Rules
- Navigate to Rules Section: In the Capture Step editor, find the Rules section.
- Click the "+" Button: Add a new rule.
- Define Your Rule:
- Write a natural language statement that describes the validation criteria for the entity collection.
- Example: "The email address must be valid and cannot be from a free email provider like Gmail or Yahoo."
Multiple Rules
- You can add multiple rules to cover all necessary validation for your entities.
- The LLM will consider all rules when extracting and validating entities from the user's input.
2. Exit Scenarios
Purpose
- Manage Conversation Flow: Define conditions under which the agent should stop trying to capture the entities and proceed differently.
- Enhance User Experience: Prevent frustration by not repeatedly asking for information the user cannot or does not want to provide.
How to Add Exit Scenarios
- Navigate to Exit Scenarios Section: In the Capture Step editor, find the Exit Scenarios section.
- Click the "+" Button: Add a new exit scenario.
- Define Your Exit Scenario:
- Specify phrases or conditions that indicate the user cannot provide the entities.
- Example: "If the user says 'I don't have an email address' or 'I'd prefer not to share that.'"
Multiple Exit Scenarios
- You can add multiple exit scenarios to handle different user responses.
Exit Scenario Path Toggle
Purpose
- Customize Conversation Paths: Decide whether to direct the user down a separate path if an exit scenario is triggered.
How to Use
- Exit Scenario Path Toggle:
- ON:
- An additional exit port appears on the Capture Step.
- When an exit scenario is triggered, the conversation flows through this separate path.
- Use Case: Direct the user to an alternative flow, such as offering different options or providing additional assistance.
- OFF:
- No additional exit port is created.
- When an exit scenario is triggered, the conversation continues through the main capture port.
- Use Case: Proceed with the conversation as if the entities were captured, possibly with default values or by skipping certain steps.
- ON:
Summary of the Capture Step Configuration
-
Select Capture Mode:
- Entire User Reply: Capture and store the full user input.
- Entities: Extract specific entities from the user's input.
-
Configure Options:
- No Reply: Handle situations where the user doesn't respond.
- Listen for Other Triggers: Allow or prevent the agent from recognizing other intents during this step.
-
For Entity Capture:
- Add Entities: Choose or create the entities you want to capture.
- Automatically Reprompt: Enable the system to generate dynamic reprompts for incomplete or invalid inputs.
- Define Rules: Set validation criteria for the collection of entities.
- Set Exit Scenarios: Determine conditions under which to stop capturing entities and how to proceed.
- Exit Scenario Path: Decide whether to use a separate path when an exit scenario is triggered.
Practical Example: Capturing User Contact Information
Let's walk through an example to illustrate how to use the Capture Step effectively.
Scenario
You want to collect the user's first name, last name, and email address.
Steps
-
Add a Capture Step to Your Canvas.
-
Configure to Capture Entities:
- Select Entities:
FirstName
(Custom)LastName
(Custom)EmailAddress
(Custom)
- Select Entities:
-
Set Options:
- No Reply: Enable with a timeout of 30 seconds and a reprompt like "Please let me know if you're still there."
- Listen for Other Triggers: Disable to focus on capturing the required information.
-
Enable Automatically Reprompt:
- Model Settings:
- Temperature: 0.7 for a balance between creativity and predictability.
- Max Tokens: 50 to limit the length of reprompts.
- System Prompt: "Politely ask the user for any missing information."
- Model Settings:
-
Define Rules:
- Rule: "Ensure both first name and last name are provided, and the email address must be valid and not from a disposable domain."
-
Set Exit Scenarios:
- Exit Scenario: "If the user says 'I don't want to provide my email,' 'I prefer not to share personal information.'"
- Exit Scenario Path Toggle: Enable to create a separate path.
- Connect the Exit Port: Direct to a step that says, "No problem, we can proceed without your email."
Conversation Flow Example
- Agent: "Could you please provide your first name, last name, and email address?"
- User: "I'm John."
- Agent: "Thanks, John. May I have your last name as well?"
- User: "Doe."
- Agent: "Great, and could you provide your email address?"
- User: "I'd rather not share that."
- Agent: "No problem, we can proceed without your email."
- [Conversation continues along the exit scenario path.]
Best Practices
- Be Clear with Prompts: Ensure that your initial prompt clearly states what information you're requesting.
- Write Effective Rules: Use natural language to define rules that cover all entities in the collection.
- Consider User Privacy: Always provide options for users to opt out of providing certain information.
- Test Your Configuration: Use Voiceflow's testing tools to simulate conversations and ensure that your Capture Step behaves as expected.
- Monitor and Iterate: Collect user data (in compliance with privacy laws) to understand how users interact with your agent and adjust your design accordingly.
Updated 5 days ago