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

26 lines
696 B
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# CLEAR TOOLS Keyword
**Syntax**
```
CLEAR TOOLS
```
**Parameters**
_None_ This keyword takes no arguments.
**Description**
`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
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.