> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# エージェントをインストルメント化する
> サポートされている任意のエージェントフレームワークを、1回の呼び出しで Failproof AI に接続します。
あなたのエージェントはすでに記録すべきすべてのデータを生成しています — モデル呼び出し、ツール呼び出し、ノードの境界、人間の待機、失敗。フレームワークはそれを捨ててしまいます。SDKはそれを保持します。
自分で書いたエージェント、またはここに記載されていないエージェント。
グラフ、ノード、ツール、リトリーバー、モデル。
クルー、フロー、役割別エージェント、ツール。
ワークフロー、ステップ、ファンクションエージェント、リトリーバー。
型付きエージェント、ケイパビリティ、ツール、リトライ。
## どのフレームワークでも3行で
```bash LangGraph theme={null}
pip install 'failproofai-sdk[langgraph]'
```
```bash CrewAI theme={null}
pip install 'failproofai-sdk[crewai]'
```
```bash LlamaIndex theme={null}
pip install 'failproofai-sdk[llamaindex]'
```
```bash Pydantic AI theme={null}
pip install 'failproofai-sdk[pydantic-ai]'
```
```bash Custom agents theme={null}
pip install failproofai-sdk
```
```python theme={null}
import failproofai_sdk
failproofai_sdk.configure(environment="production")
failproofai_sdk.instrument() # インポートしたフレームワークを自動検出
with failproofai_sdk.session():
... # 既存のエージェント呼び出し、変更不要
```
関数へのデコレーター不要、呼び出しへのコールバック渡し不要、コード全体へのID受け渡し不要。変わるのはセッション内の呼び出しだけです：
```python theme={null}
graph.invoke({"messages": [HumanMessage("...")]})
```
```python theme={null}
Crew(agents=[analyst, writer], tasks=[gather, summarise]).kickoff()
```
```python theme={null}
await agent.run("...") # `async with failproofai_sdk.session():` の下で
```
```python theme={null}
agent.run_sync("...")
```
```python theme={null}
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` でマシンの接続を確認してください。[キャプチャのセットアップ](/ja/start/setup) を参照してください。
配信確認のためにスプールディレクトリを確認しないでください。Failproof デーモンは各バッチをミリ秒以内に収集・削除するため、ディレクトリを読み取るとコレクターと競合し、実際に送出されたイベントよりはるかに少ないイベントしか表示されません。
## 次のステップ
上記の各クイックスタートはフルガイドへのリンクです — 記録される内容、オプション、ストリーミング、スパン名、実際によく起きる問題について説明しています。これらは **Trace Agents → Plug in your agent** の下にあります。
データモデル、ID、イベントタイプ、そしてイベントがクラウドに到達する仕組み。
切り離されたログではなく、セッション全体の因果関係を追う。
キャプチャしたセッションを監査する。