> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/ja/build/teams/traces.md).

# チームの実行記録

チームの各実行記録について、所属する会話、経由した Agent、それぞれのトークン使用量と所要時間を確認できます。会話で絞り込み、同じ会話のすべての実行記録を表示することもできます。

チームは Agent 間で自動的に引き継ぎや委任を行い、その過程はユーザーには見えません。**実行記録**では、各会話が実際にどの Agent を経由し、それぞれがどれだけのリソースを使ったかを振り返ることができます。チームが想定どおりに役割分担できているかの確認や、問題の調査と改善に役立ちます。

## <mark style="color:blue;">1. 実行記録を確認する</mark> <a href="#view-traces" id="view-traces"></a>

チームのページで**実行記録**ビューに切り替えると、このチームの実行履歴が一覧表示されます。ユーザーがチームにメッセージを1件送るたびに、記録が1件作成されます。各記録には次の項目が含まれます。

| 項目        | 説明                                                                                                                                  |
| --------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| **記録 ID** | この実行を一意に識別する ID です。                                                                                                                 |
| **会話**    | この実行が属する会話です（会話のタイトルで表示されます）。タイトルをクリックすると「すべての会話」が開き、会話全体を確認できます。                                                                   |
| **ステータス** | 「実行中」「完了」「失敗」「タイムアウト」「返信待ち」のいずれかです。「返信待ち」は、チームが「ユーザーの返信を待ってから続行」を有効にしたエッジに到達して停止したことを示します。下記の[返信待ちの記録](#waiting-for-user)を参照してください。 |
| **反復回数**  | この実行で Agent 間のやり取りが行われた合計回数です。                                                                                                      |
| **トークン数** | この実行で使用したトークンの合計数です（入力 `in`／出力 `out`）。                                                                                              |
| **所要時間**  | メッセージを受信してから返信が完了するまでの合計時間です。                                                                                                       |
| **作成日時**  | この実行が行われた日時です。列見出しをクリックすると、古い順と新しい順を切り替えられます。並び順を指定しない場合は、新しい順が初期設定です。                                                              |

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-823fb555400af54c89c714cb0a7639da6e51acf8%2Fteams-traces-list.png?alt=media" alt="記録 ID、会話、ステータス、反復回数、トークン数、操作が表示されたチームの実行記録一覧"><figcaption><p>実行記録：各記録に所属する会話のタイトルが表示されるため、同じ会話の記録を一目で確認できます</p></figcaption></figure>

{% hint style="info" %}
**会話のタイトルを開けませんか？** タイトルをリンクとして表示するには、「会話履歴」へのアクセス権限が必要です。権限がない場合は通常のテキストで表示されます（タイトルにカーソルを合わせると理由が表示されます）。
{% endhint %}

## <mark style="color:blue;">2. 会話で実行記録を絞り込む</mark> <a href="#filter-by-conversation" id="filter-by-conversation"></a>

通常、1つの会話には複数のメッセージがあり、それぞれに実行記録が作成されます。特定の会話をまとめて確認したい場合は、その会話に属する記録だけを表示できます。

### 1. この会話で絞り込む <a href="#apply-conversation-filter" id="apply-conversation-filter"></a>

確認したい記録の右側にある「操作」列で、漏斗アイコンの <mark style="color:blue;">この会話で絞り込む</mark> をクリックします。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-af8dbc17a102a15908d4afd228598b5f3c4180e8%2Fteams-traces-filter-by-conversation.png?alt=media" alt="操作列の漏斗アイコンにカーソルを合わせると「この会話で絞り込む」と表示される"><figcaption><p>記録の右側にある漏斗アイコン「この会話で絞り込む」をクリックします</p></figcaption></figure>

### 2. 絞り込み結果を確認する <a href="#filtered-result" id="filtered-result"></a>

一覧の上に「**会話「…」の実行記録のみを表示しています**」という通知バーが表示され、その下にはこの会話の記録だけが残ります。ページ送りや並べ替えをしても、絞り込みは維持されます。このとき、これらの記録の漏斗アイコンはグレーになり、カーソルを合わせると「この会話の記録をすでに表示中です」と表示されます。

完全な一覧に戻すには、通知バー右側の <mark style="color:blue;">クリア</mark> をクリックするか、閉じる（×）をクリックします。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-09594aef5f67452c4713db76671ae7d12e207195%2Fteams-traces-filtered.png?alt=media" alt="通知バーに会話の実行記録のみを表示していると示され、一覧には同じ会話の2件の記録だけが残っている"><figcaption><p>絞り込み後：通知バーに現在表示中の会話が示され、一覧にはこの会話の記録だけが残ります</p></figcaption></figure>

### 利用シーン：クレーム対応の会話でどの Agent が返信したかを調べる <a href="#example-complaint-review" id="example-complaint-review"></a>

カスタマーサポートの責任者が、顧客から「返品の説明がわかりにくい」という声を受け、その会話の各返信がチームのどの Agent によって処理されたかを確認したいとします。

1. 「実行記録」でこの会話の記録を1件見つけ、<mark style="color:blue;">この会話で絞り込む</mark> をクリックします。一覧にはこの会話の記録だけが残ります。
2. 記録を1件ずつ展開し、ステップカードの Agent 名を確認します。最初のメッセージは「デモ－カスタマーサポート振り分けアシスタント」が受け付けた後、「デモ－返品・交換アシスタント」に引き継がれ、その後の追加質問は「デモ－返品・交換アシスタント」が直接返信していることがわかります。
3. 「会話」列のタイトルをクリックして元の会話を開き、実際の返信内容と照らし合わせます。問題が「デモ－返品・交換アシスタント」にあると確認できたら、「AI アシスタント」に戻ってその設定を調整します。

## <mark style="color:blue;">3. ステップの詳細を展開する</mark> <a href="#step-detail" id="step-detail"></a>

記録の左側にある **+** をクリックする（または行そのものをクリックする）と展開され、この実行が**どの Agent ノードをどの順に経由したか**を確認できます。各ステップは1枚のステップカードで表示されます。

| 項目            | 説明                                                                                             |
| ------------- | ---------------------------------------------------------------------------------------------- |
| **ステップ番号と名前** | 「#番号 · 名前」の形式で表示されます（例：「#1 · デモ－カスタマーサポート振り分けアシスタント」）。このステップをチームのどの Agent が処理したかが一目でわかります。     |
| **トークン使用量**   | カードの右側に、このステップの入力／出力トークン（`in` / `out`）が表示されます。ステップによっては所要時間も表示され、どの Agent にコストがかかっているかを把握できます。 |

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-89bd57ac75ba2770c1ab31ca37c0bb715213b7c0%2Fteams-trace-detail.png?alt=media" alt="展開された実行記録。ステップカードに「#1 · デモ－カスタマーサポート振り分けアシスタント」と「#2 · デモ－返品・交換アシスタント」が表示されている"><figcaption><p>ステップの詳細：各ステップカードにステップ番号と処理した Agent 名が示され、右側にそのステップのトークン使用量が表示されます</p></figcaption></figure>

### 返信待ちの記録 <a href="#waiting-for-user" id="waiting-for-user"></a>

チームが[ユーザーの返信を待ってから続行](/maiagent-user-guide/ja/build/teams/setup.md#wait-for-reply-rules)を有効にしたエッジに到達すると、そのターンは送信元の Agent が返信した後に停止し、記録のステータスは「**返信待ち**」と表示されます。これは正常な終了であり、失敗ではありません。展開すると、ステップカードの下に通知カードがもう1枚表示されます。

* 「**ユーザーの返信待ち**」：このターンはここで停止し、ユーザーの次のメッセージを待っています。
* 「**返信後の引き継ぎ先：○○**」：ユーザーが返信した後に、どの Agent が引き継ぐかを示します。ここには停止した時点の Agent 名が表示され、後から名前を変更しても変わりません。

ユーザーが返信すると、続きのターンは別の記録として作成され、ステップカードは引き継ぎ先の Agent から始まります。

<figure><img src="https://2584873290-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTvHx8hgwYGDTLD3A7xoW%2Fuploads%2Fgit-blob-9139f96ee3307d293980fe3d180361de3214cc32%2Fteams-traces-waiting-for-user.png?alt=media" alt="展開された実行記録：ステータスは返信待ちで、ステップカード「#1 · docs-line デモ（架空）カスタマーサポート振り分けアシスタント」の下に、ユーザーの返信待ちと、返信後の引き継ぎ先「docs-line デモ（架空）返品・交換アシスタント」を示す通知カードが表示されている"><figcaption><p>返信待ちの記録：展開すると、どの Agent で停止したか、ユーザーの返信後に誰へ引き継ぐかを確認できます</p></figcaption></figure>

{% hint style="info" %}
**API で実行記録を取得できますか？** 現在、実行記録は管理画面の「**実行記録**」ビューでのみ確認でき、公開されている [API ドキュメント](https://docs.maiagent.ai/api)にはまだ含まれていません。分析のためにエクスポートが必要な場合は、MaiAgent の担当窓口にご相談ください。
{% endhint %}

{% hint style="info" %}
**記録が表示されませんか？** 実行記録は、チームが実際に会話で呼び出された後にのみ作成されます。一覧が空の場合は、まずチームの対話プラットフォームからチームと何度か会話してから、改めて確認してください。
{% endhint %}

## <mark style="color:blue;">4. 記録を活用してチームを改善する</mark> <a href="#optimize" id="optimize"></a>

* **ルーティングが想定と異なる**：ステップカードの Agent 名から、質問が誤った Agent に引き継がれていることがわかった場合は、[キャンバスでの編成](/maiagent-user-guide/ja/build/teams/setup.md#compose-canvas)に戻り、エッジの「トリガー条件の説明」を調整して、「どのような場合にこのエッジを通るか」をより明確に記述します。
* **反復回数や所要時間が多い**：Agent 間で引き継ぎが何度も行き来している可能性があります。不要なエッジがないか確認するか、チームの「最大イテレーション数」と各ノードの設定を調整してください。
* **コストが特定の Agent に集中している**：各ステップカードのトークン使用量を比較し、最もトークンを使っている Agent を見つけます。より軽量なモデルへの切り替えや、ナレッジベースとツールの範囲の絞り込みを検討してください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/build/teams/traces.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.