エージェントをインストルメント化する

あなたのエージェントはすでに記録すべきすべてのデータを生成しています — モデル呼び出し、ツール呼び出し、ノードの境界、人間の待機、失敗。フレームワークはそれを捨ててしまいます。SDKはそれを保持します。

カスタムエージェント

自分で書いたエージェント、またはここに記載されていないエージェント。

LangChain と LangGraph

グラフ、ノード、ツール、リトリーバー、モデル。

CrewAI

クルー、フロー、役割別エージェント、ツール。

LlamaIndex

ワークフロー、ステップ、ファンクションエージェント、リトリーバー。

Pydantic AI

型付きエージェント、ケイパビリティ、ツール、リトライ。

どのフレームワークでも3行で

pip install 'failproofai-sdk[langgraph]'

pip install 'failproofai-sdk[crewai]'

pip install 'failproofai-sdk[llamaindex]'

pip install 'failproofai-sdk[pydantic-ai]'

pip install failproofai-sdk

import failproofai_sdk

failproofai_sdk.configure(environment="production")
failproofai_sdk.instrument()          # インポートしたフレームワークを自動検出

with failproofai_sdk.session():
    ...                               # 既存のエージェント呼び出し、変更不要

関数へのデコレーター不要、呼び出しへのコールバック渡し不要、コード全体へのID受け渡し不要。変わるのはセッション内の呼び出しだけです：

LangGraph
CrewAI
LlamaIndex
Pydantic AI
Custom agents

graph.invoke({"messages": [HumanMessage("...")]})

Crew(agents=[analyst, writer], tasks=[gather, summarise]).kickoff()

await agent.run("...")        # `async with failproofai_sdk.session():` の下で

agent.run_sync("...")

with failproofai_sdk.agent("planner"):
    with failproofai_sdk.tool_call("search", input={"q": q}) as t:
        t.output = search(q)

追加インストールはフレームワークをインストールします。すべてのアダプターはベースホイールに同梱されているため、すでにフレームワークを持つプロジェクトは追加インストールが不要です。

到達確認

インストルメント化したセッションを1回実行し、Observe → Sessions を開いて環境を選択します。実行結果が再構成されたトレースとして表示されます。何も届かない場合は、failproofai config --status でマシンの接続を確認してください。キャプチャのセットアップを参照してください。

配信確認のためにスプールディレクトリを確認しないでください。Failproof デーモンは各バッチをミリ秒以内に収集・削除するため、ディレクトリを読み取るとコレクターと競合し、実際に送出されたイベントよりはるかに少ないイベントしか表示されません。

次のステップ

上記の各クイックスタートはフルガイドへのリンクです — 記録される内容、オプション、ストリーミング、スパン名、実際によく起きる問題について説明しています。これらは Trace Agents → Plug in your agent の下にあります。

仕組み

データモデル、ID、イベントタイプ、そしてイベントがクラウドに到達する仕組み。

トレースを読む

切り離されたログではなく、セッション全体の因果関係を追う。

最初の障害を見つける

キャプチャしたセッションを監査する。

カスタムエージェント

LangChain と LangGraph

CrewAI

LlamaIndex

Pydantic AI

​どのフレームワークでも3行で

​到達確認

​次のステップ

仕組み

トレースを読む

最初の障害を見つける

どのフレームワークでも3行で

到達確認

次のステップ