Direct Tool Execution

from observee_agents import execute_tool

# Get YouTube transcript directly
transcript = execute_tool(
    tool_name="youtube_get_transcript",
    tool_input={"video_url": "https://youtube.com/watch?v=example"}
)

# Search web directly
search_results = execute_tool(
    tool_name="brave_search",
    tool_input={"query": "Python 3.12 features"}
)

# Create Linear issue directly
issue = execute_tool(
    tool_name="linear_create_issue",
    tool_input={
        "title": "New Feature Request",
        "description": "Add dark mode support"
    }
)

Tool Discovery

from observee_agents import filter_tools, list_tools

# List all available tools
all_tools = list_tools(observee_api_key="obs_your_key_here")
print(f"Found {len(all_tools)} tools")

for tool in all_tools[:5]:  # Show first 5
    print(f"- {tool['name']}: {tool['description']}")

Filter Tools by Task

from observee_agents import filter_tools

# Find productivity tools
productivity_tools = filter_tools(
    query="productivity task management",
    max_tools=5
)

for tool in productivity_tools:
    print(f"📋 {tool['name']}: {tool['description']}")

# Find communication tools
comm_tools = filter_tools(
    query="communication messaging slack email",
    max_tools=3
)

for tool in comm_tools:
    print(f"💬 {tool['name']}: {tool['description']}")

# Find content creation tools
content_tools = filter_tools(
    query="youtube video content creation",
    max_tools=5
)

for tool in content_tools:
    print(f"🎥 {tool['name']}: {tool['description']}")

Get Tool Information

from observee_agents import get_tool_info

# Get detailed info about a specific tool
tool_info = get_tool_info(
    tool_name="youtube_get_transcript",
    observee_api_key="obs_your_key_here"
)

if tool_info:
    print(f"Tool: {tool_info['name']}")
    print(f"Description: {tool_info['description']}")
    print(f"Parameters: {tool_info['parameters']}")