Tool Categories
The built-in tools are organized into the following categories:Artifact Management
Tools for creating, reading, updating, and managing artifacts within agent sessions.Data Analysis
Tools for analyzing data, creating visualizations, and generating charts.Audio Tools
Tools for text-to-speech generation, audio transcription, and audio manipulation.Image Tools
Tools for image generation, editing, and analysis using AI models.Research Tools
Tools for web search and comprehensive research capabilities.General Utility Tools
Tools for file conversion, diagram generation, and web requests.Embeds
A powerful system for dynamic content interpolation and artifact references.Tool Configuration
Built-in tools are configured in your agent’s YAML configuration file under thebuiltin_tools section:
Tool Scopes
Each tool requires specific scopes to be granted to the agent. Scopes control which tools can be accessed:Common Patterns
Using Tools in Sequence
Tools can be chained together to accomplish complex tasks:Error Handling
All tools return aToolResult object with status information:
Next Steps
Artifact Management
Learn how to manage files and data within agent sessions
Data Analysis
Explore data analysis and visualization tools
Audio Tools
Generate and process audio content
Image Tools
Create and manipulate images with AI
General Tools
File conversion, diagrams, and web requests
Research Tools
Web search and deep research capabilities