Meta tools are currently in beta and may change in future versions. They provide powerful dynamic capabilities for AI agents that can discover and execute tools based on natural language queries.
Meta tools enable AI agents to dynamically discover and execute the right tools without hardcoding tool names. This is particularly useful for building flexible AI assistants that can handle various user requests intelligently.

Architecture Overview

Meta tools consist of two main functions:
  • meta_search_tools: Searches for relevant tools based on natural language queries using BM25 semantic search
  • meta_execute_tool: Executes discovered tools with the provided parameters

How It Works

Benefits

  • Dynamic Discovery: No need to hardcode tool names or maintain static lists
  • Multi-Tenant Ready: Agents adapt to available integrations per customer
  • Natural Language: Search tools using descriptive queries
  • Intelligent Routing: BM25 algorithm finds the most relevant tools automatically

Python Implementation

In the Python SDK, meta tools are implemented using:
  • BM25S Library: Efficient BM25 implementation for semantic search
  • NumPy Integration: Fast numerical operations for score calculation
  • Pydantic Models: Type-safe data structures for search results and tool parameters

Advanced Use Cases

Multi-Agent Workflows

Meta tools integrate seamlessly with popular Python AI frameworks like LangChain, CrewAI, and LangGraph. Convert meta tools to framework-specific formats for direct integration with your chosen AI framework.

Dynamic Tool Discovery

Build intelligent agents that adapt to available integrations by discovering tools based on user intent and routing to the most relevant tools automatically.

Custom Scoring Logic

Implement business rules for tool selection by filtering based on score thresholds and applying custom preferences to match your specific use cases.

Framework Compatibility

Meta tools work with all major Python AI frameworks:
  • LangChain: For sophisticated agent workflows
  • CrewAI: For multi-agent team collaboration
  • LangGraph: For stateful agent workflows
  • OpenAI: For direct function calling

Next Steps