Promptetheus – AIエージェントの障害をトレース、検出、自動修復

Promptetheus は、AI エージェントの障害をトレース、検出、自動修復するためのデバッグ基盤です。このプロジェクトは Python SDK を中心に、ローカルリプレイツール、ホステッドトレース配信、および MCP 証拠アクセスを組み合わせ、AI エージェントに包括的な可観測性を提供します。

コア機能には、1 つのユーザー可視エージェントタスクにつき 1 つのトレースが含まれます。デコレータ（@pt.observe、@pt.tool など）を使用して既存のコードに簡単に統合でき、ユーザーメッセージ、エージェントメッセージ、ツール呼び出し、ブラウザ操作、DOM スナップショット、スクリーンショット、LLM 呼び出し、検索、メトリクス、エラー、スコア、最終目標チェックなどのイベントを記録します。SDK は永続的な配信メカニズムを採用しており、HTTP 配信が設定されていないか失敗した場合でも、イベントはローカルにスプールされ、後でリプレイできます。

ローカル開発では、Promptetheus は豊富な CLI ツールを提供します。promptetheus sessions でローカルセッションを一覧表示し、promptetheus replay でフラットなタイムラインまたはツリー構造を表示、promptetheus fingerprint で障害フィンガープリントを生成、promptetheus spool でローカルイベントキャッシュを管理できます。さらに、promptetheus import でエクスポートされたセッションをインポートすることも可能です。

Promptetheus は非同期エージェントとブラウザエージェントをサポートします。非同期エージェントには AsyncSession クラスを提供し、ブラウザエージェントではユーザー目標、重要なブラウザ操作、最終 DOM 状態、明示的な目標チェックを記録することを推奨します。これにより、Promptetheus は障害をリプレイし、修復エビデンスを生成できます。

フレームワークアダプタはオプションであり、pip install "promptetheus[openai]" などでインストールできます。サポートされるアダプタには、AnthropicAdapter、OpenAIAdapter、LangGraphAdapter などがあります。フレームワークが既に構造化コールバックを提供している場合は、アダプタを使用して手動インストルメンテーションを避けることができます。

AgentRuntime は、ライブなサービスバックアップによる調整のためのベストエフォート型クライアントです。永続的なトレースストレージとは分離されており、サービスが利用不可の場合でもホストコードにエラーを発生させません。remember、before_tool_call、after_tool_call、heartbeat などのメソッドを提供し、エージェントが実行時にヒントを得るのに役立ちます。

MCP 証拠アクセスが必要な場合、Promptetheus はホステッド MCP クライアント設定を生成でき、Codex、Claude、Cursor などのクライアントをサポートします。生成された設定は読み取り専用で、ワークスペースと Supabase プロジェクトスコープの証拠にアクセスします。

要約すると、Promptetheus は開発から本番まで AI エージェントのための完全なデバッグソリューションを提供し、開発者がエージェントの実行中に発生する問題を迅速に特定して修正できるようにします。