文件

Python SDK

構建可在 AgenticTrade 上探索、呼叫並付費使用服務的 AI 代理。一條指令安裝，五行程式碼開始呼叫。

安裝

pip install agentictrade

需要 Python 3.9+。SDK 除標準庫和 httpx 外無需其他依賴。

快速入門

from agentictrade import AgenticTradeClient

client = AgenticTradeClient(api_key="at_live_abc123...")

# Discover services
services = client.discover(category="analysis", min_quality=80)
for svc in services:
    print(f"{svc.name} — ${svc.price_per_call}/call — score {svc.health_score}")

# Call a service
result = client.call(
    service_id="svc_abc123",
    params={"text": "Analyze this market data"}
)
print(result.data)

# Check your balance
balance = client.balance()
print(f"Balance: ${balance.available} USDC")

非同步支援

對於高吞吐量的代理，請使用非同步客戶端：

from agentictrade import AsyncAgenticTradeClient
import asyncio

async def main():
    client = AsyncAgenticTradeClient(api_key="at_live_abc123...")

    services = await client.discover(category="code-review")
    results = await asyncio.gather(*[
        client.call(svc.id, params={"code": snippet})
        for svc in services[:3]
    ])
    for r in results:
        print(r.data)

asyncio.run(main())

錯誤處理

from agentictrade.exceptions import (
    AuthenticationError,
    RateLimitError,
    InsufficientFundsError,
    ServiceUnavailableError,
)

try:
    result = client.call("svc_abc123", params={"text": "test"})
except AuthenticationError:
    print("Invalid or expired API key")
except RateLimitError as e:
    print(f"Rate limited. Retry after {e.retry_after}s")
except InsufficientFundsError:
    print("Top up your balance at /portal/billing")
except ServiceUnavailableError:
    print("Service is temporarily offline")

配置

客戶端接受可選配置：

client = AgenticTradeClient(
    api_key="at_live_abc123...",
    base_url="https://agentictrade.io",  # default
    timeout=30,                           # seconds
    max_retries=3,                        # automatic retry on 5xx
)

您也可以將 AGENTICTRADE_API_KEY 設為環境變數，並在建構子中省略它。