showholdings-agentmon 0.1.0

Python SDK for Show Holdings AgentOps monitoring

showholdings-agentmon

showholdings-agentmon 是 Show Holdings AgentOps 的 Python SDK。

它讓你可以在自己的 Python 程式中，用最小改動接入 run-level monitoring。

安裝

pip install showholdings-agentmon

最小使用範例

from showholdings_agentmon import Monitor

monitor = Monitor(
    api_key="YOUR_API_KEY",
    base_url="https://agentops.showholdings.com",
    project_name="my-agent",
)

with monitor.run(agent_name="general-agent", session_id="session-123"):
    result = run_my_agent()

SDK 行為說明

• 進入 with monitor.run(...) 時，自動呼叫 POST /api/sdk/runs/start
• 離開 context 時，自動呼叫 POST /api/sdk/runs/end
• 成功結束會送出 status=success
• 區塊內拋出例外會送出 status=failed，並附帶：
  • failure_reason_type（例外類別名稱）
  • error_count=1
• SDK 對監控 API 採 best effort；監控 API 失敗不會中斷你的主要業務流程

本地開發

pip install -e .[dev]
pytest
python -m build

發布概要

本專案已提供 GitHub Actions：

• ci.yml：在 push / pull_request 執行測試
• publish.yml：以 PyPI Trusted Publishing 為目標的正式發布流程

你可先用 TestPyPI 驗證流程，再切換到正式 PyPI 發布。