> 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/maiagent-user-guide-ja/agent-ops/agent-ops.md).

# AgentOps 総覧

## AgentOps とは? <a href="#what-is-agent-ops" id="what-is-agent-ops"></a>

AgentOps (Agent Operations) は、MaiAgent プラットフォームが提供する AI アシスタントの運用管理モジュールであり、AI アシスタントの実際のパフォーマンスをテスト・評価・監視することに重点を置いています。AgentOps を活用することで、AI アシスタントの品質を体系的に管理し、常に優れたサービス体験を提供し続けることができます。

## なぜ AgentOps が必要なのか? <a href="#why-agent-ops" id="why-agent-ops"></a>

AI アシスタントを構築するのは第一歩にすぎません。長期的な成功を実現するには、継続的な監視と最適化が欠かせません。AgentOps は次のことを支援します。

**品質の安定を確保**

* 標準化されたテストの仕組みを構築
* AI アシスタントのパフォーマンスの変化傾向を追跡
* 品質上の問題を早期に発見し修正

**運用効率の向上**

* テストプロセスを自動化し、人的リソースを節約
* パフォーマンスのボトルネックを迅速に特定
* システムリソースとコストを最適化

**データドリブンな意思決定**

* AI アシスタントのパフォーマンス指標を定量化
* 異なる設定やモデルの効果を比較
* 実際のデータに基づいて最適化戦略を策定

## AgentOps の主要機能 <a href="#agent-ops-core-features" id="agent-ops-core-features"></a>

### 1. テストデータセット管理 <a href="#test-dataset-management" id="test-dataset-management"></a>

テストケースのコレクションを作成・管理し、AI アシスタントの応答品質を検証します。

**主な機能:**

* 複数のテストデータセットを作成
* テストケースと期待される応答を管理
* 検索と分類に対応
* チームでテストケースを共同メンテナンス

**活用シーン:**

* ナレッジベース更新後の応答精度の検証
* 標準的なテストプロセスの構築
* よくある質問を収集してテスト基準として活用

> 詳細な説明: [テストデータセット管理](/maiagent-user-guide/maiagent-user-guide-ja/agent-ops/test-datasets.md)

### 2. 自動評価 <a href="#auto-evaluation" id="auto-evaluation"></a>

テストデータセットを使用して評価を自動実行し、詳細な品質レポートを生成します。

**主な機能:**

* ワンクリックで一括テストを実行
* 成功率と応答時間を算出
* 詳細な合格/不合格レポートを生成
* 異なる時期や AI アシスタントのパフォーマンスを比較

**活用シーン:**

* 定期的な品質チェック
* 更新前後のリグレッションテスト
* 異なる AI アシスタントやモデルの効果を比較

> 詳細な説明: [自動評価](/maiagent-user-guide/maiagent-user-guide-ja/agent-ops/evaluations.md)

### 3. AI アシスタント監視 <a href="#ai-agent-monitoring" id="ai-agent-monitoring"></a>

AI アシスタントの稼働状況をリアルタイムで監視し、一つひとつの対話の詳細を深く分析します。

**主な機能:**

* 入力/出力メッセージの内容を確認
* 返信時間と処理時間を追跡
* Token 使用量とコストを監視
* 品質スコアとユーザーからのフィードバックを分析

**活用シーン:**

* システムの稼働状況をリアルタイムで監視
* パフォーマンスの問題や異常を特定
* コストと使用量を追跡
* 個別の対話を深く分析

> 詳細な説明: [AI アシスタント監視](/maiagent-user-guide/maiagent-user-guide-ja/agent-ops/evaluations.md)

## AgentOps のワークフロー <a href="#agent-ops-workflow" id="agent-ops-workflow"></a>

### 標準的な品質管理フロー <a href="#standard-quality-management-flow" id="standard-quality-management-flow"></a>

```
1. テストデータセットを作成
   ↓
   よくある質問と期待される応答を収集
   構造化されたテストケースを構築

2. 自動評価を実行
   ↓
   定期的に、または更新後にテストを実行
   成功率と品質レポートを生成

3. 評価結果を分析
   ↓
   失敗したケースを特定
   改善が必要な問題を洗い出す

4. AI アシスタントを最適化
   ↓
   ナレッジベースの内容を更新
   AI 設定とプロンプトを調整

5. 実際の運用を監視
   ↓
   AI アシスタント監視で実際の対話を追跡
   品質の安定を継続的に確保

6. 継続的に改善
   ↓
   監視データから新たな問題を発見
   テストデータセットを更新
   評価と最適化のサイクルを繰り返す
```

### クイックスタートの手順 <a href="#quick-start-steps" id="quick-start-steps"></a>

**1 週目: 基礎テストの構築**

1. よくある質問を 20〜30 個収集する
2. 最初のテストデータセットを作成する
3. 初回の自動評価を実行する
4. 現在の成功率をベースラインとして記録する

**2 週目: 継続的な最適化**

1. 失敗したテストケースを分析する
2. ナレッジベースを更新するか AI 設定を調整する
3. 評価を再実行して改善効果を検証する
4. AI アシスタント監視を使い始めて実際の対話を観察する

**3 週目: 習慣の確立**

1. 週に 1 回、自動評価を実行する
2. 毎日、監視データを確認して異常を特定する
3. より多くのシーンをカバーするためテストケースを継続的に追加する
4. 品質レポートを作成して長期的な傾向を追跡する

## AgentOps と他機能との統合 <a href="#agent-ops-integrations" id="agent-ops-integrations"></a>

### AgentOps + ナレッジベース管理 <a href="#agent-ops-plus-knowledge-base" id="agent-ops-plus-knowledge-base"></a>

**統合活用:**

* ナレッジベースを更新したら、すぐに自動評価を実行して検証
* 監視データが知識不足を示している場合、ナレッジベースの内容を補充
* 実際の対話からテストケースを作成し、逆にナレッジベースを最適化

> 関連ドキュメント: [企業ナレッジベースの構築](/maiagent-user-guide/maiagent-user-guide-ja/km/km.md)

### AgentOps + 利用分析 <a href="#agent-ops-plus-usage-analytics" id="agent-ops-plus-usage-analytics"></a>

**相互補完の分析:**

* **利用分析**: 全体的な傾向と統計を提供 (対話量、満足度など)
* **AgentOps**: 深い品質分析と個別の対話の詳細を提供

組み合わせて使用することで、次のことが可能になります。

* 全体的な傾向から異常を発見する
* 監視の詳細から根本原因を突き止める
* AI アシスタントのパフォーマンスを総合的に評価する

> 関連ドキュメント: [利用分析](/maiagent-user-guide/maiagent-user-guide-ja/org/usage.md)

### AgentOps + 返信品質コントロール <a href="#agent-ops-plus-reply-quality-control" id="agent-ops-plus-reply-quality-control"></a>

**統合活用:**

* AgentOps は技術面の品質監視を提供
* 返信品質コントロールは人手によるレビューとラベル付けを提供
* 両者を組み合わせることで、完全な品質保証体制を構築できます

> 関連ドキュメント: [返信品質コントロール](https://github.com/Playma-Co-Ltd/maiagent-user-guide-gitbook/blob/main/ja/channels/quality.md)

## ベストプラクティスの提案 <a href="#best-practices" id="best-practices"></a>

### 1. 定期的な評価の仕組みを構築する <a href="#establish-regular-evaluation" id="establish-regular-evaluation"></a>

**毎日のチェック (5 分):**

* AI アシスタント監視を確認して異常を特定

**毎週の評価 (30 分):**

* 中核となるテストデータセットを実行
* 成功率が安定して維持されているか確認
* テストケースを更新または追加

**毎月の分析 (2 時間):**

* 完全な評価を実行
* 監視データをエクスポートして深く分析
* 品質レポートを作成
* 翌月の最適化目標を計画

### 2. 品質のベースラインを設定する <a href="#set-quality-baseline" id="set-quality-baseline"></a>

お使いの AI アシスタントに合理的な品質目標を設定しましょう。

| 指標        | ベースライン | 目標    | 説明              |
| --------- | ------ | ----- | --------------- |
| 自動評価の成功率  | ≥ 85%  | ≥ 95% | 標準テストケースの合格率    |
| 平均返信時間    | < 5 秒  | < 3 秒 | ユーザーが体感する応答速度   |
| ユーザー満足度   | ≥ 80%  | ≥ 90% | 高評価/総フィードバックの比率 |
| Token 使用量 | -      | -     | 予算に応じて上限を設定     |

### 3. 問題追跡のフローを構築する <a href="#issue-tracking-workflow" id="issue-tracking-workflow"></a>

品質上の問題を発見したとき:

```
問題の発見
↓
テストデータセットに記録 (再発を防止)
↓
根本原因を分析 (ナレッジベース/AI 設定/モデル能力)
↓
改善策を実施
↓
評価を実行して効果を検証
↓
継続的に監視して安定を確認
```

### 4. チームでの協働 <a href="#team-collaboration" id="team-collaboration"></a>

AgentOps の責任分担を構築しましょう。

**AI 管理者:**

* 全体的な品質監視
* 最適化戦略の策定
* 定期的な評価とレポート

**ナレッジベース管理者:**

* 評価結果に基づいてナレッジベースを更新
* 不足している知識内容を補充

**技術担当者:**

* パフォーマンスの問題を分析
* システム設定を最適化
* 技術的な異常に対応

### 5. 継続的改善のサイクル <a href="#continuous-improvement-cycle" id="continuous-improvement-cycle"></a>

AgentOps の中核は継続的な改善です。

1. **測定**: 評価と監視を通じてデータを取得する
2. **分析**: 問題と改善の機会を特定する
3. **行動**: 最適化策を実施する
4. **検証**: 改善効果を確認する
5. **標準化**: 成功した経験をプロセスに組み込む

## よくある質問 <a href="#faq" id="faq"></a>

### Q1: AgentOps と「利用分析」は何が違うのですか? <a href="#faq-agent-ops-vs-usage-analytics" id="faq-agent-ops-vs-usage-analytics"></a>

**利用分析:**

* 全体的な傾向と統計 (対話量、文字数、満足度)
* AI アシスタントの利用概況を把握するのに適している
* ビジネス指標に注目

**AgentOps:**

* 深い品質分析と個別の対話の詳細
* 技術面の品質管理に適している
* 技術指標に注目 (成功率、応答時間、コスト)

両者は補完関係にあるため、組み合わせて使用することをおすすめします。

### Q2: 評価はどのくらいの頻度で実行すればよいですか? <a href="#faq-evaluation-frequency" id="faq-evaluation-frequency"></a>

推奨頻度:

* **中核機能**: 週に 1 回
* **完全テスト**: 月に 1 回
* **大規模な更新後**: ただちに実行
* **問題を発見したとき**: 随時テストして検証

AI アシスタントの重要度や変更の頻度に応じて調整できます。

### Q3: テストデータセットにはどのくらいのテストケースを含めるべきですか? <a href="#faq-test-dataset-size" id="faq-test-dataset-size"></a>

推奨数:

* **最小**: 20 個のテストケース (中核機能をカバー)
* **推奨**: 50〜100 個のテストケース (カバー率と効率のバランス)
* **完全**: 200 個以上のテストケース (大規模または重要なシステム)

中核機能から始めて、段階的に拡充しましょう。

### Q4: 成功率はどのくらいで合格といえますか? <a href="#faq-success-rate-threshold" id="faq-success-rate-threshold"></a>

AI アシスタントの用途によって異なります。

* **高リスクな用途** (金融、医療): ≥ 95%
* **カスタマーサポート**: ≥ 90%
* **汎用的な対話**: ≥ 85%
* **試験的な機能**: ≥ 80%

重要なのは、ベースラインを設定して継続的に改善することです。

### Q5: AgentOps は実際のユーザーに影響しますか? <a href="#faq-impact-on-real-users" id="faq-impact-on-real-users"></a>

影響しません。AgentOps のテストと監視はいずれも独立した環境またはバックグラウンドで実行されるため、実際のユーザーの利用体験を妨げることはありません。

### Q6: 業務ごとに複数のテストを作成できますか? <a href="#faq-multiple-test-sets-per-agent" id="faq-multiple-test-sets-per-agent"></a>

できます。業務や機能ごとに複数のテストデータセットを作成することをおすすめします。

* 製品照会テストセット
* 注文処理テストセット
* テクニカルサポートテストセット
* ……など

このようにすることで、各領域の品質パフォーマンスを個別に追跡できます。

***

## AgentOps を使い始める <a href="#get-started-with-agent-ops" id="get-started-with-agent-ops"></a>

AgentOps を使い始める準備はできましたか? 次の順序で進めることをおすすめします。

1. [**テストデータセットの作成**](/maiagent-user-guide/maiagent-user-guide-ja/agent-ops/test-datasets.md): よくある質問を収集し、最初のテストセットを作成する
2. [**自動評価の実行**](/maiagent-user-guide/maiagent-user-guide-ja/agent-ops/evaluations.md): AI アシスタントをテストして評価レポートを確認する
3. [**AI アシスタント監視の利用**](/maiagent-user-guide/maiagent-user-guide-ja/agent-ops/evaluations.md): 実際の稼働状況を深く把握する

AgentOps を活用することで、体系的な品質管理プロセスを構築し、AI アシスタントが常に優れたサービスを提供し続けられるようにします。


---

# 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/maiagent-user-guide-ja/agent-ops/agent-ops.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.