botserver/docs/src/chapter-06-gbdialog/keyword-clear-tools.md

27 lines
696 B
Markdown
Raw Normal View History

2025-11-23 20:12:09 -03:00
# CLEAR TOOLS Keyword
**Syntax**
```
2025-11-23 20:12:09 -03:00
CLEAR TOOLS
```
**Parameters**
_None_ This keyword takes no arguments.
**Description**
2025-11-23 20:12:09 -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-23 20:12:09 -03:00
USE TOOL "enrollment.bas"
TALK "Enrollment tool added."
2025-11-23 20:12:09 -03:00
CLEAR TOOLS
TALK "All tools have been cleared from this conversation."
```
2025-11-23 20:12:09 -03:00
After `CLEAR TOOLS` runs, the `enrollment.bas` tool is no longer accessible in the same session.