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

エージェントはすでに記録する価値のあるすべてのデータを生成しています — モデル呼び出し、ツール呼び出し、ノード境界、人間の待機、失敗。フレームワークはそれを捨てますが、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 → エージェントの接続 以下にあります。

仕組みを理解する

データモデル、ID、イベントタイプ、そしてイベントがクラウドに届くまでの流れ。

トレースを読む

バラバラなログではなく、セッションを通じて因果関係を追う。

最初の障害を見つける

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

カスタムエージェント

LangChain と LangGraph

CrewAI

LlamaIndex

Pydantic AI

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

​到達確認

​次のステップ

仕組みを理解する

トレースを読む

最初の障害を見つける

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

到達確認

次のステップ