Skip to main content

​
Overview

System tools are automatically available to every agent and don’t require custom configuration. These tools help agents orchestrate workflows, retrieve information, and provide better user experiences.

​
Available System Tools

RAG Tool

Retrieve information from datasources

Finish Tool

Complete current agent task

End Flow Tool

Terminate the entire workflow

Flow Insight Tool

Provide status updates to users

​
RAG Tool

​
Purpose

Retrieves relevant information from datasources attached to the agent block.

​
Usage

Simply mention in your agent prompt when the tool should be called:
Agent Prompt Example
When the user asks about product specifications or documentation, 
use the RAGTool to search the knowledge base for relevant information.
The agent will automatically access the datasources you’ve attached to the agent block and retrieve the most relevant information.
Make sure to attach your datasources to the agent block before referencing the RAG Tool.

​
Finish Tool

​
Purpose

Signals that the current agent has completed its task and no further action is needed from this agent block.

​
Usage

Instruct the agent to call this tool when its specific objective is complete:
Agent Prompt Example
Once you have successfully collected the user's name, email, and phone number, 
call the FinishTool to complete this step.

​
When to Use

  • Agent has gathered all required information
  • Task objective has been accomplished
  • Ready to pass control to the next agent or step
If your agent is finishing prematurely, explicitly define the conditions for calling FinishTool in your prompt.

​
End Flow Tool

​
Purpose

Terminates the entire workflow immediately, regardless of remaining steps.

​
Usage

Use this tool when the entire flow should stop:
Agent Prompt Example
If the user explicitly says "bye" or "stop", call the EndFlowTool 
to immediately terminate the entire workflow.

​
When to Use

  • User requests to cancel the process
  • Critical error that prevents continuation
  • Flow objective has been fully completed
  • User wants to exit the conversation
This tool stops the entire workflow, not just the current agent. Use FinishTool if you only want to complete the current agent’s task.

​
Flow Insight Tool

​
Purpose

Provides real-time status updates to users during tool execution, making conversations feel more natural and interactive.

​
Usage

The agent automatically uses this tool to inform users when processing is happening:
Agent Prompt Example
When calling any external tool or API, use the FlowInsightTool to let 
the user know you're working on their request.

​
Example Responses

"One moment, I'm looking into your account details..."

​
Benefits

  • Reduces user anxiety during processing time
  • Makes the conversation feel more human
  • Provides transparency about what’s happening
  • Improves overall user experience

​
Best Practices

If your agent is calling system tools at the wrong time:✅ Do: Be explicit about when to call each tool
Call FinishTool ONLY after you have:
1. Verified the user's identity
2. Processed their request
3. Confirmed the outcome with the user
❌ Don’t: Leave tool calling conditions ambiguous
Use FinishTool when done.
If agents are ending flows too early:
  • Explicitly list all required steps before calling FinishTool/EndFlowTool
  • Add validation checkpoints in your prompt
  • Use conditional statements for tool calling
Example
Before calling FinishTool, ensure:
- User has provided all required information
- Information has been validated
- Confirmation message has been sent to user
  • Attach only relevant datasources to each agent
  • Provide clear instructions on when to search
  • Test retrieval quality with sample queries
  • Update datasources regularly for accuracy
Keep insight messages:
  • Brief and conversational
  • Relevant to the action being performed
  • Professional but friendly
  • Transparent about what’s happening

​
Troubleshooting

​
Agent ends flow prematurely
Add explicit conditions in your prompt for when to call FinishTool or EndFlowTool. List all required steps that must be completed first.
​
RAG Tool not finding information
  • Verify datasources are properly attached to the agent block
  • Check that datasources contain the relevant information
  • Review the quality and format of your datasource content
​
Flow Insight messages not appearing
  • Ensure the agent prompt mentions using FlowInsightTool
  • Verify the conversational flow is configured correctly
  • Check that the tool is being called before long-running operations