Tools
Overview
Section titled “Overview”
Tools are modular logic units that developers maintain and reuse across Assistants. Tools are built and versioned in DevStudio. Agents invoke tools to perform actions.
Managed in DevStudio
Section titled “Managed in DevStudio”Developers can:
- Edit and test tools in isolation.
- Save tools to the Workspace Library for reuse.
- Version and publish them for other assistants.
Tools used in multiple assistants should always be version-controlled.
Breaking changes must be tested in Dev before UAT or Prod.
Structure
Section titled “Structure”- Parameters and input validation
- Return schema and capture variables
- Versioning and publishing
Best practices
Section titled “Best practices”- Defensive error handling
- Secure authentication
- Return only the required data in the output to minimize token consumption, as the response is passed directly to the agent.
- Clear parameter docs and examples

