> 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/teams/traces.md).

# チーム実行記録

チームの各実行記録を確認します——どのアシスタントを経由したか、各アシスタントのトークン使用量、所要時間、ステータス、および個別ステップの入力・出力とコスト内訳を展開して確認できます。

チームはアシスタント間で自動的にハンドオフとデリゲートを行い、そのプロセスはユーザーには見えません。〈**実行記録**〉を使えば、各対話が実際に「どのアシスタントを経由し、それぞれどれだけのリソースを使ったか」を振り返って確認でき、チームが期待通りに分業しているかの確認や、トラブルシューティングと最適化に役立ちます。

## <mark style="color:blue;">一、実行記録の確認</mark> <a href="#view-traces" id="view-traces"></a>

チームページで〈**実行記録**〉ビューに切り替えると、このチームの各実行が一覧表示されます。各記録には以下の情報が含まれます：

| 項目           | 説明                           |
| ------------ | ---------------------------- |
| **記録 ID**    | この実行の一意の識別子です。               |
| **ステータス**    | 〈実行中〉〈完了〉〈失敗〉または〈タイムアウト〉。    |
| **イテレーション数** | この実行中にアシスタント間で合計何回やり取りしたかです。 |
| **トークン数**    | この実行の合計トークン使用量です。            |
| **所要時間**     | メッセージ受信から回答完了までの合計時間です。      |

## <mark style="color:blue;">二、ステップ詳細の展開</mark> <a href="#step-detail" id="step-detail"></a>

個別の記録を展開すると〈**ステップ詳細**〉が表示されます——この実行が**順番にどのアシスタントノードを経由したか**、および各ステップの詳細です：

| 項目         | 説明                                                                    |
| ---------- | --------------------------------------------------------------------- |
| **ステップ番号** | このステップはフロー全体の何番目か、どのアシスタントが実行したかです。                                   |
| **入力**     | このステップでアシスタントが受け取った内容の要約です。                                           |
| **出力**     | このステップでアシスタントが生成した内容の要約です。                                            |
| **コスト内訳**  | このステップのトークン使用量（入力トークン、出力トークン、埋め込みトークン）で、どのアシスタントにコストがかかったかを明確に確認できます。 |

{% hint style="info" %}
**記録が表示されない場合** 実行記録はチームが実際に対話でトリガーされた後にのみ生成されます。一覧に〈実行記録はまだありません〉と表示される場合は、まず対話プラットフォームでチームと数回やり取りしてから、再度確認してください。
{% endhint %}

## <mark style="color:blue;">三、記録を活用してチームを最適化する</mark> <a href="#optimize" id="optimize"></a>

* **ルーティングが期待通りでない場合**：問題が誤ったアシスタントに渡されている場合は、[キャンバス編成](/maiagent-user-guide/ja/teams/setup.md#compose-canvas) に戻ってエッジの〈トリガー条件の説明〉を調整し、「いつこのエッジを通るか」をより明確に記述してください。
* **イテレーション数や所要時間が多い場合**：アシスタント間のハンドオフが多すぎる可能性があります。不要なエッジがないか確認するか、チームの〈最大イテレーション数〉と各ノードの設定を調整してください。
* **特定のアシスタントにコストが集中している場合**：〈コスト内訳〉からトークン消費が最も多いアシスタントを特定し、より軽量なモデルへの変更や、ナレッジベースとツールの範囲の縮小を検討してください。


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.