Skip to main content

Local tools

Local tools are built-in tools provided by Moveo that your AI agent can invoke directly from guidelines. They let the agent trigger workflows, compose rich responses, execute code, detect voicemails, and search the knowledge base on demand, with no external server configuration.

note

Local tools are different from MCP servers. MCP servers connect to external tool providers, while local tools are internal to Moveo and ready to use out of the box.

Available tools​

ToolDescriptionChannel support
Evaluate responsesScreens every response for factual accuracy and security risks before Moveo delivers it. It is always on for every AI agent, and you cannot turn it off.All channels
Trigger workflowHands off the conversation to a specific workflow. The workflow takes over the response, and the AI agent does not respond separately.All channels
Compose rich responseLets the AI agent compose structured responses with buttons, carousels, images, and files.Chat, web widget, and messaging channels only. Not available on voice, email, or SMS.
Execute codeLets the AI agent run code for math calculations and complex operations.All channels
Ask questionsLets the AI agent ask the user up to five questions at once, with options to pick from.Web chat only
Voicemail detectionDetects voicemail systems and optionally leaves a message.Voice channels only
On-demand knowledge retrievalLets the AI agent fetch relevant information from the knowledge base on demand. You turn it on in the Knowledge dialog, not in the Local tab.All channels

Enable or disable a tool​

Navigate to your AI agent, open the ⋮ menu and select Tools, then select the Local tab.

The Local tab of the Tools page with a switch for each local tool. Evaluate responses is always on.The Local tab of the Tools page with a switch for each local tool. Evaluate responses is always on.

Each tool has a toggle switch. Activate a toggle to make that tool available to the AI agent. The Evaluate responses toggle is always on and locked.

warning

Disabling a tool that is referenced in your guidelines removes all its references automatically. Review your guidelines after disabling a tool that was central to the agent's behavior.

When you disable a tool that is already referenced in guidelines, a warning dialog appears:

  • The dialog explains that Moveo removes all tool references from guidelines
  • Select View guideline to review the affected guidelines before confirming
  • Select Disable to proceed, or Cancel to keep the tool enabled
The dialog This tool is referenced in the guidelines, with the View guideline, Cancel, and Disable buttons.The dialog This tool is referenced in the guidelines, with the View guideline, Cancel, and Disable buttons.

Reference a tool in guidelines​

You can reference local tools in any guideline editor: Goal, Overview, Features, Loyalty, Objections, or Custom Instructions.

Insert a tool reference​

  1. Open a guideline editor
  2. Type @ to open the suggestion menu
  3. Select a tool from the list
The @ menu in the guidelines editor with the Local tools Trigger workflow, Compose rich response, and On-demand knowledge retrieval.The @ menu in the guidelines editor with the Local tools Trigger workflow, Compose rich response, and On-demand knowledge retrieval.

The tool appears as an inline badge in the editor (for example, @compose_rich_response, @execute_code, or @search_knowledge_base).

Insert a trigger workflow reference​

The Trigger workflow tool requires you to select a specific workflow:

  1. Type @ and select Trigger workflow
  2. A workflow picker opens automatically
  3. Select the target workflow from the list
The workflow picker that opens after you select Trigger workflow, with the dialogs of the AI agent.The workflow picker that opens after you select Trigger workflow, with the dialogs of the AI agent.

The badge displays as @trigger_workflow(workflow name), where the workflow name updates automatically if you rename the workflow.

tip

If the @ menu is empty, no tools are enabled. Select the link in the empty state prompt to go to the Local tools settings and enable them.

Runtime behavior​

When the AI agent encounters a tool reference in guidelines during a conversation, it invokes the tool automatically.

Evaluate responses​

Moveo checks each response before it reaches the user. The check looks for facts that the agent's sources do not support, invented links, and attempts to make the agent act outside its guidelines. When a response fails the check, the AI agent rewrites it. You do not reference this tool in guidelines.

Trigger workflow​

The conversation hands off to the selected workflow. The workflow owns the response from that point. The AI agent does not receive a result back and does not respond separately.

Compose rich response​

The AI agent composes a structured response with elements like text with buttons, carousels, images, or files. The response is sent directly to the user.

warning

This tool only works on channels that support rich payloads (chat, web widget, messaging). Enabling it has no effect on voice, email, or SMS channels.

Execute code​

The AI agent runs code to perform complex operations such as math calculations. The result is used in the agent's response.

Voicemail detection​

The AI agent detects whether a voicemail system has answered and can optionally leave a message.

warning

This tool only works on voice channels. Enabling it has no effect on other channels.

On-demand knowledge retrieval​

The AI agent can use the search_knowledge_base tool to search the knowledge base during the conversation. This tool is not in the Local tab. The search option of the knowledge base controls it. With Search on every message, Moveo searches before each reply, and the Also search during the reply setting adds the tool for extra searches. With Search only when needed, the tool is always on, and the agent searches only through the tool.

Delete a workflow referenced in guidelines​

When you delete a workflow that is referenced by @trigger_workflow in guidelines, a warning appears:

  • The dialog explains that Moveo removes the tool reference from guidelines
  • Select View guideline to review the affected guidelines
  • On confirmation, all @trigger_workflow references pointing to that workflow are removed automatically

Troubleshooting​

The @ menu shows no tools

No local tools are enabled. Go to your AI agent → ⋮ → Tools → Local tab and enable the tools you need.

Tool references disappeared from guidelines

Tool references are removed automatically when you disable a tool or delete a workflow that the tool points to. Re-enable the tool and re-insert the references.

Compose rich response has no effect

This tool only works on channels that support rich payloads (chat, web widget, messaging). It has no effect on voice, email, or SMS channels.

Voicemail detection has no effect

This tool only works on voice channels. It has no effect on chat, web, email, SMS, or messaging channels.


Next steps​

  • MCP servers: connect external tools via the Model Context Protocol
  • Workflows: build conversation workflows that tools can trigger