Skip to main content
Manage the tools in your active environment.

​
Listing tools

Use the orchestrate tools list command to list all tools in your environment. You can also use the --verbose (-v) flag to get detailed information about each tool in JSON format.
BASH
orchestrate tools list -v

​
Exporting tools

Use the orchestrate tools export command to export a tool configuration from your active environment. The command exports Python, Agentic Workflow and Langflow tools, and only OpenAPI tools that were imported using CLI.
BASH
orchestrate tools export -n <tool-name> -o <zip-output-path>
Note:
  • Starting with version 1.12.0, agentic workflow tools export only when you use a local environment with watsonx Orchestrate Developer Edition.
  • Starting with version 1.15.0, you can export agentic workflow tools in SaaS environments using this command. This feature is now available in Public Preview.
  • Starting with version 1.15.0, exporting an agentic workflow tool also exports all tools associated with that workflow.

​
Updating tools

To update a tool, run the import command again using the same tool name that you want to update.
BASH
orchestrate tools import -k <kind of the tool> -f <path the tool file that you want to update> -a <id of the app> -r <path to the requirements.txt file>

​
Removing tools

Use the orchestrate tools remove command to remove an existing tool. This command requires the --name (-n) flag, which specifies the name of the tool you want to delete.
BASH
orchestrate tools remove -n my-tool-name