ShadAI Framework
  1. advanced
ShadAI Framework
  • Index
  • README
  • Pricing
    • Pricing Plan
  • advanced
    • Best Practices
    • Tool Orchestration
    • Performance Optimization
    • Custom Tools
  • examples
    • Advanced Patterns
    • Custom Agent Examples
    • Market Research Examples
    • Multi-Document Analysis
    • Basic Query Examples
  • api-reference
    • Exceptions Reference
    • Engine Tool API
    • Shadai Client API Reference
    • Query Tool API
    • Summarize Tool API
    • Agent Tool API
    • Web Search Tool API
  • use-cases
    • Knowledge Synthesis
    • Research Assistant
    • Custom Workflows
    • Document Q&A
  • core-concepts
    • Architecture
    • Intelligent Agent
    • RAG System
    • Tools Overview
  • guides
    • Memory & Context
    • Streaming Responses
    • File Ingestion
    • Error Handling
    • Session Management
  • getting-started
    • Authentication
    • Your First Query
    • Quick Start
    • Installation
  1. advanced

Custom Tools

Create powerful custom tools for your Shadai agents.

Tool Basics#

Minimum Requirements#

Required:
1.
@tool decorator
2.
Type hints
3.
Docstring
4.
Return string

Tool Design Principles#

Single Responsibility#

✅ Good:
❌ Bad:

Clear Descriptions#

✅ Good:

Type Safety#

Advanced Patterns#

Error Handling#

Data Formatting#

Async Tools#

Testing Tools#

Integration Examples#

Database Tool#

API Tool#

File System Tool#

Best Practices#

✅ Do This#

❌ Don't Do This#

See Also#

Intelligent Agent
Tool Orchestration
Custom Agent Examples
Modified at 2025-10-17 17:45:30
Previous
Performance Optimization
Next
Advanced Patterns
Built with