ナレッジサービス¶
Obsy Copilot は、現在のセッションにおける分析結果をプラットフォームノートや Runbook として整理したり、公式製品ドキュメントを検索して使い方に関する質問に回答することができます。ノートは確定した結論を保存するのに適しており、Runbook は繰り返し実行可能な操作手順を蓄積するのに適しています。また、製品ドキュメント QA は、公式ドキュメントに沿った活用方法を入手するために用います。
ノートと Runbook の作成¶
障害調査、ログ分析、クエリの説明、ソリューションの検討などが完了した後、現在のセッションにおいて長期的に価値のある内容をノートまたは Runbook として整理することで、再度手動でコピーしたり再構成したりする手間を省くことができます。
| コンテンツタイプ | 適用内容 | 例 |
|---|---|---|
| 通常ノート | 結論、背景情報、クエリの説明、分析記録などの参考情報 | ある障害の原因分析と影響範囲 |
| Runbook | 繰り返し使用可能な対処手順。通常、前提条件、操作手順、確認方法、および必要な場合のロールバック手順やエスカレーションパスを含む | checkout-api のタイムアウトに関する標準的な調査・復旧手順 |
トリガー方法¶
以下の方法で作成フローに入ることができます。
- 能動的な生成：会話内で「上記の分析をノートにまとめて」「最新のトレース分析をノートとして保存して」と入力するか、「この
checkout-apiのタイムアウト調査を Runbook にまとめて」と明確にリクエストします。 - Obsy Copilot からの提案：会話がある程度完成された分析結果や操作手順を形成している場合、Obsy Copilot がノートまたは Runbook にまとめるかどうかを提案することがあります。
範囲を限定する必要がある場合は、整理対象のオブジェクト、内容、タイプを明確に指定してください。例えば、「最新の分析をノートにまとめて」は最新の実質的な結果のみを整理し、「現在のセッションをノートにまとめて」は現在のセッション内で蓄積可能な複数の項目をカバーできます。Runbook を作成する際は、適用対象、トリガー条件、および残しておきたい確認手順についても併せて指定することを推奨します。
作成フロー¶
- Obsy Copilot は、現在のアカウントにノート作成権限があるかどうかを確認します。
- 指定された範囲とコンテンツタイプに基づいて草稿を整理し、確認カードにタイトル、内容範囲、セクション、タグなどの情報を表示します。
- 確認カードをチェックし、問題がなければ作成を承認します。
- 作成が成功すると、Obsy Copilot が結果カードを返します。名前をクリックすると、対応するノートまたは Runbook を開くことができ、現在の会話を閉じる必要はありません。
草稿では、セッション内に既に存在するクエリやチャートのサマリーを参照できますが、完全な生ログ、巨大なクエリ結果、または無関係な過去の内容がそのままノートや Runbook に書き込まれることはありません。
検索と保守¶
Obsy Copilot に対して、名前や内容で既存のノートや Runbook を検索し、その内容の読み取り、更新、削除を依頼することができます。例えば：
検索結果は、まずタイトル、タイプ、タグなどの基本情報を表示します。内容の確認や変更が必要な場合、Obsy Copilot が完全な Markdown コンテンツを読み取ります。
作成後は、コンテンツタイプを変更することはできません。通常ノートを Runbook に直接変換することはできず、Runbook を通常ノートに変更することもできません。タイプを変更する必要がある場合は、目的のタイプで内容を再作成してください。
Runbook は自動実行されません
Runbook は、操作手順を蓄積し再利用するための知識コンテンツであり、自動化実行エンジンではありません。後で Runbook に従って問題に対処する場合、実際のデータクエリ、設定変更、または対処アクションは、その時点のアカウント権限、ツール権限、および操作確認ルールの制約を受けます。
注意
- ノートを作成するには、現在のアカウントにノートモジュールの作成権限が必要です。権限がない場合は、管理者に連絡して有効にしてもらってください。
- ユーザーが確認するまでは草稿のみが生成され、実際のノートや Runbook は作成されません。
- 現在のセッションの内容が不足している場合、Obsy Copilot は不足している情報を説明するか、既存の結論のみを整理します。
- 作成後は、重要な結論、操作手順、クエリの参照、およびオブジェクト範囲を確認してから、その後の共有や対応に使用してください。
製品ドキュメント QA¶
製品ドキュメント QA 機能は、プラットフォームの公式ヘルプドキュメントを検索し、機能の説明、エントリー位置、設定ルール、操作手順、一般的なトラブルシューティングに関する質問に回答し、必要に応じて該当するドキュメントへのリンクを提供します。
以下のような製品に関する問題に対応できます。
- ある機能の役割やエントリーがわからない。
- インストール、接続、作成、設定の手順が必要。
- フィールド、デフォルト値、バージョン要件、使用制限を確認したい。
- 設定後もデータが送信されない、または有効にならないため、順を追って調査が必要。
- 該当する公式ヘルプドキュメントを入手したい。
製品質問の送信¶
実行したいタスクを直接説明し、関連する製品、モジュール、問題の段階を明記してください。例えば：
複雑な問題の場合は、最終目標と現在の進捗状況を同時に説明してください。Obsy Copilot は、前提条件、操作手順、確認方法に沿って回答を構成します。ドキュメントへのリンクのみが必要な場合は、「該当するドキュメントはどこですか」と明確に入力することもできます。
回答とドキュメント参照¶
Obsy Copilot は、検索されたドキュメントに基づいて回答を整理し、必要に応じてアクセス可能なサイトリンクを提供します。設定やトラブルシューティングに関する問題については、回答はまず実行順序、制限事項、確認方法を優先して説明します。
製品ドキュメント QA は説明のみを提供し、ユーザーに代わってリソースの作成、変更、削除、インストール、デプロイは行いません。検索結果だけでは特定のルールを確認するには不十分な場合、Obsy Copilot は、一般的な知識を使ってドキュメントにない結論を補完するのではなく、証拠が不十分であることを明確に説明します。