Overview
Bolt Agent Teams control how and where your agents are deployed across student communication channels—Messenger, SMS, Email, and WhatsApp. Simply activating an agent doesn’t make it accessible to students—it must be assigned to a team.
Teams let you decide when and where an agent appears using conditions such as Page URL, Path URL, UTM Parameters, or Conversation Channel. This enables the display of the right agent(s) to the right students at the right time.
👉 Important: Teams do not apply to the Phone channel or to Bolt Agent Jobs.
For example, you might create an Athletics Team that includes an Athletics Advisor and an Admissions Advisor, configured to appear only on pages containing “athletics” in the URL. This ensures the right audience connects with the right team for assistance.
Key Considerations for Teams
Sequential order: Teams are checked in order from top to bottom.
Conditions must be met: The first team whose conditions are met becomes active.
Fallback team: Always have one “default team” with no conditions, placed last in the list. This ensures there’s always a backup if no other team matches.
Logical grouping: Build teams around areas of expertise (e.g., Financial Aid, Admissions, Athletics). This makes agent handoffs smoother and ensures students connect with the most qualified agent.
Messenger vs. Other Channels
Teams are most powerful and customizable on Messenger because you can apply multiple conditions, including Page URL, Path URL, and UTM Parameters. This allows you to scope your deployment with precision.
For other channels, such as SMS, Email, and WhatsApp, you can only use the Channel condition. This means you can’t target a specific phone number or email address; the condition simply applies to the entire channel.
How-To: Add a Team
Navigate to Engagement > Bolt Agents.
Locate the Teams section.
Click + Add Student Agents Team.
Configure the settings for the agent:
Name: Enter a name for the team in the header.
Enabled: Use this toggle to activate the team now or later.
Student Agents: Select the Agent(s) you wish to add to the team.
Conditions: Add the rules that control when this team should appear.
For Messenger, you can add Page URL, Path URL, UTM Parameter, and/or Channel.
For SMS, Email, and WhatsApp, you can only use the Channel condition.
Click Save in the top right corner.
How-To: Edit + Delete Team
Go to Engagement > Bolt Agents.
In the Teams section, find the team you want to edit or delete.
Click the three-dot menu on the right.
Select Edit or Delete. (If deleting, you’ll be asked to confirm.)
Reordering Teams
Team conditions are evaluated top to bottom. Use the drag handles (represented by two horizontal lines) to adjust the order.
🚨 Important: Place your “default” team without conditions at the bottom, or any teams below it will be ignored.
Agent-to-Agent Handoffs
Our intelligent Bolt Agents can seamlessly hand off queries to one another within the same team, ensuring students get the help they need without unnecessary delays. This mirrors real-life interactions but operates far more efficiently than navigating from office to office or building to building.
Same-Team Handoffs: Agents can only hand off to other agents assigned to the same team. This setup ensures students receive specialized help as needed.
Automated Process: Handoffs happen automatically—there’s no setting to enable/disable the feature. If an agent can’t assist with a specific task, it will check if another agent on the team can handle it before offering to hand off to a human (if this skill is enabled).
Internal Descriptions: Each agent has an internal description setting (explained in the Agent Settings section). This field provides context about the agent's skills and knowledge areas. Internal descriptions are readable by other agents on the same team, enabling them to determine when a handoff is appropriate.
Default Agent: The default agent, used when students select “I’m not sure” when prompted to choose an agent, doesn’t hand off to others. As an all-knowing agent, it serves as a fallback. To minimize unnecessary human handoffs, ensure the default agent is configured with the same skills as your other agents.