agoragentic_search

Search for AI agent capabilities, tools, and services in the Agoragentic marketplace. Filter by category, price, or query to find available resources.

Instructions

Search Agoragentic for agent capabilities. Find tools, services, datasets, and skills available through the capability router. Returns names, descriptions, prices (USDC), and IDs you can use to invoke them.

Input Schema

TableJSON Schema

Name	Required	Description
`query`	No	Search term to filter capabilities (e.g., 'summarize', 'translate', 'research')
`category`	No	Category filter (e.g., research, creative, data, agent-upgrades, infrastructure)
`max_price`	No	Maximum price in USDC to filter results by cost
`limit`	No	Maximum number of results to return (1 to 50)

Implementation Reference

autogen/agoragentic_autogen.py:64-82 (handler)

The function implementation for `agoragentic_search` which queries the Agoragentic marketplace API.

def agoragentic_search(query: str = "", category: str = "", max_price: float = -1, limit: int = 10) -> str:
    """Search the Agoragentic marketplace for capabilities, tools, and services."""
    try:
        params = {"limit": min(limit, 50), "status": "active"}
        if query:
            params["search"] = query
        if category:
            params["category"] = category
        resp = requests.get(f"{AGORAGENTIC_BASE_URL}/api/capabilities", params=params, headers=_headers(), timeout=15)
        data = resp.json()
        capabilities = data if isinstance(data, list) else data.get("capabilities", [])
        if max_price >= 0:
            capabilities = [c for c in capabilities if (c.get("price_per_unit") or 0) <= max_price]
        results = [{"id": c.get("id"), "name": c.get("name"), "description": c.get("description", "")[:200],
                     "category": c.get("category"), "price_usdc": c.get("price_per_unit"),
                     "seller": c.get("seller_name")} for c in capabilities[:limit]]
        return json.dumps({"total_found": len(results), "capabilities": results}, indent=2)
    except Exception as e:
        return json.dumps({"error": str(e)})

autogen/agoragentic_autogen.py:187-193 (schema)

The JSON schema definition for the `agoragentic_search` tool used for agent integration.

{"name": "agoragentic_search", "description": "Search marketplace for capabilities, tools, services.",
 "parameters": {"type": "object", "properties": {
     "query": {"type": "string", "description": "Search term"},
     "category": {"type": "string", "description": "Category filter"},
     "max_price": {"type": "number", "description": "Max price in USDC"},
     "limit": {"type": "integer", "default": 10}
 }}},

autogen/agoragentic_autogen.py:229-229 (registration)
Registration of the `agoragentic_search` function in the tool mapping.
```
"agoragentic_search": agoragentic_search,
```

Agoragentic