Skip to main content

System Tools List

This article lists the system (built-in) tools available to every AI agent. Unlike custom tools, system tools don’t require you to add a specific tool group. To use a system tool, reference it by name in the available_tools section of your workflow configuration.

For customer tools and how to add them, see Custom Tools

Tool Summary​

This table lists all available system tools provided by the platform.

Tool NamePurposeStatus
SendChatMessageSends a stylized message to the userCore tool
FinishSessionEnds and closes the current sessionCore tool
SearchToolSemantic search across tools and knowledge base (VDB)System tool (routing)
ProvideOptionButtonsShows interactive option buttons to the userSystem tool (UI)
SuggestChatMessageSuggests a message to the human operatorCopilot mode
SearchInKnowledgeBaseSearches the vector-based Knowledge BaseRAG tool
NoKBAnswerHandles cases where no info is found in the KBRAG tool

Communication Tools​

SendChatMessage​

  • Purpose: Sends a stylized message to the user in the agent's speech style and language.
  • Parameters:
    • stylized_message — a string with the message to display to the user.
  • Note: This is the basic tool for any text communication. Used in almost every state where the AI agent responds with text.

SuggestChatMessage​

  • Purpose: Generates a suggested response for a human operator instead of sending it directly to the user.
  • Status: Copilot mode.
  • Usage: Used in "Copilot" workflows where the AI assists a human agent by drafting replies that the human can approve or edit.

Session & State Management​

FinishSession​

  • Purpose: Ends and closes the current user session. Can be used as a logical conclusion or during escalation to a human agent
  • Parameters:
    • last_message — final message shown to the user before ending the session.
  • Note: Recommended for any scenario involving session closure (logical conclusion or escalation). It explicitly notifies the system that the conversation is over.

UI & Interaction Tools​

ProvideOptionButtons​

  • Purpose: Displays interactive response options as buttons to the user.
  • How it works: Takes an observation — a list of options returned by other tools — and shows them to the user
  • Example usage: When the agent needs the user to select a specific category or confirm an action (Yes/No), this tool ensures structured input.

⚠️ Note: ProvideOptionButtons only renders UI options. State transitions and business logic are handled by the agent and workflow.

Tool & Skill Discovery​

SearchTool​

  • Purpose: Performs semantic search across available tools and the vector database (Knowledge Base).
  • Status: System tool (routing).
  • How it works: SearchTool acts as a router. Instead of hardcoding specific tools for every scenario, the agent uses this tool to "look up" the best action or information source based on the user's intent.
  • Why it matters: Enables dynamic agent behavior and efficient tool selection in complex agents with many capabilities.

Knowledge Base Tools​

SearchInKnowledgeBase​

  • Purpose: Searches the vector-based Knowledge Base for relevant information.
  • Usage notes:
    • This is the primary tool for Retrieval-Augmented Generation (RAG) workflows.
    • Replaces older specific search tools.
    • Required if the agent needs to answer questions based on uploaded documents.

NoKBAnswer​

  • Purpose: Informs the flow that no relevant information was found in the Knowledge Base.
  • Usage notes:
    • Used in RAG workflows to gracefully handle gaps in knowledge.
    • Allows the agent to fall back to general knowledge or escalate to a human if the specific answer isn't in the database.