botserver/docs/src/chapter-05/keyword-clear-tools.md

27 lines
696 B
Markdown
Raw Normal View History

# CLEAR_TOOLS Keyword
**Syntax**
```
CLEAR_TOOLS
```
**Parameters**
_None_ This keyword takes no arguments.
**Description**
2025-11-21 23:23:53 -03:00
`CLEAR_TOOLS` removes every tool that has been added to the current conversation session. It clears the list of active tools stored in the sessiontool association table, effectively resetting the tool environment for the dialog. After execution, no previously added tools (via `USE_TOOL`) remain available.
**Example**
```basic
2025-11-21 23:23:53 -03:00
USE_TOOL "enrollment.bas"
TALK "Enrollment tool added."
CLEAR_TOOLS
TALK "All tools have been cleared from this conversation."
```
After `CLEAR_TOOLS` runs, the `enrollment.bas` tool is no longer accessible in the same session.