Skip to main content
Utility Tools provide dynamic tool discovery and execution capabilities for Python applications, allowing your AI agents to explore and use tools at runtime. You can simply ask for “tools that list employees” instead of memorising exact action names.

​
Quick Start

from stackone_ai import StackOneToolSet

# Initialise the toolset
toolset = StackOneToolSet()

# Fetch tools for your account
all_tools = toolset.fetch_tools(account_ids=["your_account_id"])

# Get utility tools for dynamic discovery
utility_tools = all_tools.utility_tools()

# Search for relevant tools
search_tool = utility_tools.get_tool("tool_search")
result = search_tool.call(
    query="manage employees create update list",
    limit=5,
    minScore=0.3
)

print("Found tools:")
for tool in result.get("tools", []):
    print(f"- {tool['name']} (score: {tool['score']:.2f})")

# Execute a discovered tool
execute_tool = utility_tools.get_tool("tool_execute")
if result.get("tools"):
    best_tool = result["tools"][0]
    execution_result = execute_tool.call(
        toolName=best_tool["name"],
        params={"limit": 10}
    )
    print(f"Result: {execution_result}")

​
Core Functions

Search for relevant tools based on natural language queries: 
search_tool = utility_tools.get_tool("tool_search")
result = search_tool.call(
    query="employee time off management",
    limit=3,
    minScore=0.4
)

​
tool_execute

Execute any tool dynamically by name: 
execute_tool = utility_tools.get_tool("tool_execute")
result = execute_tool.call(
    toolName="hibob_list_employees",
    params={"department": "engineering", "limit": 20}
)

​
Framework Integration

​
LangChain

from langchain_openai import ChatOpenAI

# Convert to LangChain tools
langchain_tools = utility_tools.to_langchain()
model = ChatOpenAI(model="gpt-5")
model_with_tools = model.bind_tools(langchain_tools)

response = model_with_tools.invoke(
    "Find employee management tools and list recent hires"
)

​
CrewAI

from crewai import Agent

# Convert to CrewAI tools
crewai_tools = utility_tools.to_crewai()

hr_agent = Agent(
    role="HR Assistant",
    goal="Help with employee management tasks",
    tools=crewai_tools,
    verbose=True
)

​
Best Practices

  1. Cache Tool Searches: Store search results to avoid repeated API calls
  2. Handle Failures: Utility tools may fail if integrations are unavailable
  3. Use Specific Queries: More specific searches return better results
  4. Validate Parameters: Check tool parameters before execution
  5. Set Reasonable Limits: Don’t search for too many tools at once

​
Example

examples/utility_tools_example.py
View on GitHub →

​
Next Steps