# AI Agents の概要

> Source: https://docs.lorel.ai/guides/ai-agents/

インシデント発生時やステータス変更時に連動して自律的に原因分析やタスク作成などの対応を行う、AI エージェントの機能仕様、個別パラメータ、および運用ルールについて説明します。

## 概要

Lorel.ai の AI エージェント（Agents）は、インシデントの発生などをきっかけとして、あらかじめ定義された初動対応を自律的に実行する機能です。

インシデント発生時に文脈情報（ログ、検知イベント、関連インシデントなど）を自動で収集し、AI モデルによる状況分析を行ったうえで、インシデントへの分析結果の追記やタスク作成などのアクションを実行します。

標準搭載エージェント・カスタムエージェントのいずれも、ポリシーに基づく自動実行のほか、ユーザーが対象インシデントを指定して手動で即時実行できます。また、インシデントへ影響を与えずに動作を確認できるテスト実行（dry-run）や、連続実行を防ぐ実行頻度制限機能を提供しています。過去の実行については、一覧や詳細の閲覧に加え、総実行数を確認できます。

AI エージェントには、次の2種類があります。

- **標準搭載エージェント（AI Agent from JIG-SAW / 組み込み）**

  Lorel.ai に標準機能として最初から登録されており、初期状態のまますぐに利用できるエージェント群です。インシデントの新規発生時に自律起動し、種類に応じて状況分析や初動対応を自動で行います。

- **カスタムエージェント（カスタム）**

  自社の運用ルールに合わせて、AI への指示内容（プロンプト）、実行頻度の制限、連携ツール、および実行するアクション（タスク作成や通知など）を自由に設計できるエージェントです。

いずれのエージェントも、実際に自動実行させるには「インシデントポリシー」への割り当て（紐付け）が必要です。ポリシーに割り当てられていないエージェントは、有効な状態であっても自動実行されません。

## できること

AI エージェント機能において、プロジェクトに参加している各ユーザーがシステム上で実行できる操作・機能の一覧です。

| 機能・操作 | 説明 | 対象のロール |
|---|---|---|
| カスタムエージェントの作成・編集・削除 | 独自のプロンプトやアクション、実行頻度、ツール連携を設定したカスタムエージェントを新規作成、更新、またはプロジェクトから削除します。 | プロジェクト管理者 / 編集者 |
| 有効化・無効化の切り替え | エージェントの稼働ステータスを「有効」または「無効」に切り替えます。無効化されたエージェントは自動実行および手動実行の対象外となります。 | プロジェクト管理者 / 編集者 |
| 手動実行 | 対象インシデントを指定して、エージェントをその場で即時実行します（有効なエージェントのみ実行可能）。 | プロジェクト管理者 / 編集者 |
| テスト実行（dry-run） | インシデントへの追記やタスク作成などの副作用を発生させずに、推論動作をテストします。 | プロジェクト管理者 / 編集者 |
| 一覧の閲覧・検索・絞り込み | 登録されているすべてのエージェントを一覧表示し、タブ（すべて/組み込み/カスタム）での絞り込みやキーワード検索を行います。 | プロジェクト管理者 / 編集者 / ワーカー / 閲覧者 |
| エージェント設定詳細の確認 | 基本情報、エージェントツール設定、データ設定などの定義内容を確認します。 | プロジェクト管理者 / 編集者 / ワーカー / 閲覧者 |
| 実行履歴の閲覧 | エージェントごとに過去の実行一覧（ページネーション表示）や、個々の実行の詳細ログ（入出力、エラー、スキップ理由）を確認します。 | プロジェクト管理者 / 編集者 / ワーカー / 閲覧者 |
| 総実行数の確認 | エージェントの総実行数を確認します。 | プロジェクト管理者 / 編集者 / ワーカー / 閲覧者 |
| 紐付いているポリシーの確認 | エージェントを自動起動対象として割り当てているインシデントポリシーの一覧を確認し、各ポリシー画面へ遷移します。 | プロジェクト管理者 / 編集者 / ワーカー / 閲覧者 |
| 個人情報（PII）保護設定の変更 | AI への入力および分析結果の出力に含まれる個人情報（住所、メールアドレス、ユーザー名、電話番号）の保護方法を変更します。 | プロジェクト管理者 / 編集者 |

## AI エージェントの動作と設定仕様

標準搭載エージェントの仕様、カスタムエージェントの作成・管理、各詳細設定項目、および実行検証に関する詳細な仕様です。

### 1. 標準搭載エージェント

初期状態で Lorel.ai に組み込まれているエージェントの基本仕様です。

- **提供エージェントの役割**: インシデント発生時のログ・イベント分析や原因推定など、運用フェーズに応じた初動対応の役割を担うエージェントがあらかじめ提供されます。
- **新規プロジェクトでの自動用意**: 新規にプロジェクトを作成した時点で、事前の追加設定を行うことなく自動的に「有効」な状態で用意されます。
- **トリガー（自動実行の起点）**: インシデントの新規発生を起点として自動実行されます。起動条件の変更はできません。なお、自動起動を行うにはインシデントポリシーへの明示的な割り当てが必要です。ポリシーに割り当てがない場合は起動せず、他のエージェントが自動で代替実行することもありません。
- **手動実行**: 自動起動の条件に関わらず、有効化されている標準搭載エージェントは、対象のインシデント画面から手動で即時実行できます。
- **内容の変更可否（固定仕様）**: 組み込みのエージェントであるため、新規作成、名称・概要・判断内容・トリガー条件・実行アクションの変更、および削除は行えません。利用者が行える操作は「有効/無効の切り替え」および「情報保護設定の変更」のみです。
- **実行頻度の制限（固定仕様）**: 上限回数は利用者側では変更できません。

### 2. カスタムエージェントの作成・編集・削除

カスタムエージェントにおけるライフサイクル、および設定変更に関する仕様の定義です。

- **エージェントを作成**: プロジェクト管理者および編集者のロールに制限された新規登録機能です。登録時に定義される項目構成は以下の通りです。
  - 基本情報（名前、説明(任意)、プロンプト）
  - アクション設定（最大10件）
  - 実行頻度の制限
  - エージェントツール設定（Runbook、Sources、Access：合計最大20件）
  - 自動で渡す情報（関連インシデント、検知イベント）
  - 情報保護設定（エージェント個別のPII保護）

  ※契約プランによるカスタムエージェントの作成個数制限はありません。

- **エージェントを編集**: 作成されたカスタムエージェントは、いつでも設定内容を変更・更新できます。名前、説明(任意)、プロンプト、実行頻度、アクション設定、エージェントツール設定、自動で渡す情報、および情報保護設定の更新が可能です。
  - **起動条件はエージェント側では選択しません**: カスタムエージェントの作成・編集時に「どのインシデントイベントで起動するか」を選ぶ項目はありません。作成時に自動的に、配送経路のある全イベント種別（作成時・解決時・再オープン時・エスカレーション時）が候補として登録されます。このうち、現在画面で選べるのは作成時・解決時・再オープン時です。実際にどの条件で起動させるかは、インシデントポリシー側でこのエージェントを紐づける際に指定します（詳細は「Rules の概要」ガイドの「AI エージェントの割り当て仕様」を参照）。
- **エージェントを削除**: 不要となったカスタムエージェントは削除できます。削除操作を実行すると、エージェントの設定データはプロジェクト内から完全に消去され、元に戻す（復旧する）ことはできません。実行履歴も今後参照できなくなります。

### 3. 基本情報

エージェントの基本的な識別情報と指示内容を定義する、画面最上部のエリアです。

- **名前（カスタムのみ）**: エージェントの名称を入力します（最大255文字）。
- **説明(任意)（カスタムのみ）**: エージェントの役割や概要を入力します（最大1,000文字）。※標準搭載エージェントでは「概要」としてあらかじめ設定された説明が表示されます。
- **プロンプト（カスタムのみ）**: エージェントに与える具体的な指示内容（プロンプト）を入力します（最大10,000文字）。

### 4. アクション設定

エージェントがインシデントに対応して実行する個別処理の仕様です。1つのカスタムエージェントにつき最大10件まで組み合わせて設定できます。

| アクション種別 | 概要 | 必須設定項目 | 任意設定項目 |
|---|---|---|---|
| インシデントに注記 | AI が生成した根本原因の分析結果をインシデントの対応履歴に書き込みます。※標準搭載エージェントはこのアクションのみを実行します。 | なし（AI 生成内容が自動追記） | — |
| タスクを作成 | インシデントの調査・対応に必要なタスクを起票します。 | タイトル、重要度、担当者の決め方（インシデントの担当者と同じ／メンバーを指定。メンバー指定の場合は担当メンバーも） | 期日（実行日から何日後か。空欄なら未設定） |
| インシデントを更新 | トリガーとなったインシデントの項目を1つ更新します（タイトル・説明・重要度・担当者・ステータス。エスカレーションは選べません）。 | 更新する項目、更新後の値 | — |
| タスクを更新 | あらかじめ指定した1件のタスクの項目を1つ更新します（重要度・担当者・ステータス）。実行のきっかけになったタスクが自動で対象になるわけではありません。 | 対象のタスク、更新する項目、更新後の値 | — |
| 分析結果を知らせる | 記録した分析結果を、指定した宛先（ロール・メンバー）にベルとメールで知らせます（本文は先頭500文字のプレビュー）。 | 通知先の決め方、宛先のロールまたはメンバー | — |

- **実行の承認仕様**: 標準搭載エージェントの「インシデントに注記」は承認プロセスを挟まず自動実行されます。各アクションには「承認が必要」を設定できます。承認が必要なアクションに達すると実行は「承認待ち」で一時停止し、実行履歴またはインシデント画面でプロジェクトの編集者以上が承認または却下します。24時間以内に承認されない場合は「承認期限切れ」となります。Runbook の提案は常に承認が必要です。

### 5. 実行頻度の制限

短時間での連続実行によるシステム過負荷や大量起動を防ぐための機能です。

- **標準搭載エージェント**: 利用者側で上限を変更することはできません。
- **カスタムエージェント**: エージェントごとに個別に制限値を設定できます。
  - 上限回数
  - 集計ウィンドウ（期間(分)）

  ※設定しない場合は無制限となります。上限を超えた実行（自動・手動とも）は自動的にスキップされます。

- **プラン上限との関係**: 上記とは別に、月間のAI実行数の上限は契約プランにより異なります（Starter は月10回まで。Standard・Enterprise は上限がなく、実行数に応じて従量課金されます。未契約時や非対応プラン時は実行不可）。なお、テスト実行（dry-run）の実行回数はこれらの上限カウントから除外されます。

### 6. エージェントツール設定

外部ツールとの連携状況を定義します。ここに設定されているツール（Runbook、Sources、Access）は、エージェントが分析中に必要だと判断したときだけ自律的に呼び出す仕組みになっており、設定されていても実行のたびに必ず呼び出されるとは限りません。

- **Runbook（カスタムのみ）**: エージェントが対処手順として提案できる Runbook を選択します。提案するかどうかはエージェントが分析結果から判断し、実際に実行するかどうかは人が承認して決定します。
  - **アクションとの連動仕様**: エージェントが Runbook を提案した場合は、タスク作成など事前に設定した通常のアクションは実行されません。実行直前の再確認で提案が無効となった場合も同様です。Runbook を提案しなかった場合のみ、事前に設定された通常アクション（最大10件まで）が実行されます。
  - **実行モードの制約**: 連携する Runbook 等の実行モードは「提案（実行には人による確認・承認が必要）」のみがサポートされており、承認を経ずに自動実行するモードは選択できません。
- **Sources（カスタムのみ）**: エージェントが読み取ることのできる監視イベントの取得元を選択します。エージェントは分析時に、選択した Sources が取り込んだ直近のイベントを、期間と件数を指定して読み取ります（読み取り専用）。エンドポイントなどの詳細な接続設定は、サイドバーの Sources 画面で管理します。
- **Access（カスタムのみ）**: エージェントが外部サービスの状態を直接確認するための接続設定を選択します。選択できるのは、状態が［利用可能］で、許可する操作が参照（読み取り）のみの Access です。書き込み操作を含む Access、操作を1つも選んでいない Access、［検証待ち］［利用停止］の Access、および手動承認で有効化した Access は選択できません。エージェントは分析時に、その Access で許可されている操作の範囲内で参照APIを自律的に選んで実行し、現在の稼働状態を確認します（参照のみ可能であり、リソースの変更操作は実行できません）。
  - **リージョン制限仕様**: 接続設定を紐付ける際、参照に使用する既定リージョンを指定します（必須）。あわせて参照を許可するリージョンを限定することもできます（省略した場合は、リージョンによる制限は行われません）。
  - **登録上限数**: 連携ツール（Runbook、Sources、Access）の登録は、1つのカスタムエージェントあたり合計で最大20件までとなります。また、同一の対象を重複して登録することはできません。
- **このエージェントを使っているポリシー**: このエージェントを自動実行するように割り当てているインシデントポリシーの一覧です。実際に自動で実行させるにはポリシー側での紐付けが必要となるため、ここに表示がない場合は自動起動しません。

### 7. データ設定

エージェントが状況分析を行う際に参照するデータ、および情報の保護に関するセキュリティを定義します。

- **自動で渡す情報**: 分析の実行時にシステム側で自動的に収集され、AI への指示（プロンプト）に毎回含められる前提情報です。
  - **インシデント本体の自動連携**: トリガーとなった対象インシデントの情報（タイムラインやコメントを含むすべて）は、設定状況に関わらず常に自動で渡されます。
  - **関連インシデント（カスタムのみ）**: 同じインシデントポリシーで過去に発生したインシデント一覧（簡易情報）を取り込みます。参照する期間（分/時間/日）と最大件数で絞り込むことで、分析時に過去の類似傾向をAIに把握させるかどうかを決定します。
  - **検知イベント**: インシデントを検知した実際のイベント（アラート等）と、その検知ルールの内容を取り込みます。指定した最大件数はインシデント1件ごとに適用され、関連インシデントを取り込む設定にしている場合は、過去のインシデントそれぞれに対しても同じ件数まで適用されます。
- **情報保護設定（PII保護）**: AIとの間で送受信されるデータに含まれる個人情報（住所、メールアドレス、ユーザー名、電話番号）の保護レベルです。標準エージェントはプロジェクト単位、カスタムエージェントはエージェント単位で個別に保護方法を設定・変更できます（未設定時の既定は「保護なし」）。AIへの入力（送信前）および分析結果の出力（保存・表示前）それぞれに対して、「ブロックする」「内容を隠す」「保護なし」の3段階を設定します。なお、個人情報の検出は完全ではないため、機微な情報を含む入力はできるだけ避けてください。
  - **入力（エージェントに渡す前）**: 個人情報が検出された場合、処理を中断してAIへ送信しない（エージェントに渡す前にブロックする）、伏せ字（マスク）にして送信する（エージェントに渡す前に内容を隠す）、そのまま送信する（保護なし）から選択します。
  - **出力（結果の保存・表示前）**: 分析結果に個人情報が含まれる場合、インシデントへの書き込みを遮断する（結果に含まれる場合ブロックする）、伏せ字にして保存・表示する（結果の内容を隠す）、そのまま保存・表示する（保護なし）から選択します。

  ※クレジットカード番号やクラウドの認証キーなど、特に重要な機微情報については、設定の有無に関わらずシステムによって常に自動で保護されます。

### 8. 実行と検証・履歴・統計

エージェントの動作検証、および過去に実行されたアクティビティ履歴と統計の仕様です。

- **手動実行**: 有効化されているエージェントに対し、対象のインシデントを指定してその場で即時実行する機能です。標準搭載エージェント・カスタムエージェントの双方が対象です。※インシデントの指定は必須であり、指定しない実行は行えません。※無効化されているエージェントは実行できません。
- **テスト実行（dry-run）**: 本番の処理経路を通りつつ、インシデントへの分析追記やタスク作成、Runbook のキューイングなどの副作用を一切発生させずにエージェントの動作を試す検証機能です。※テスト実行の履歴は保存されず、月間の課金実行回数としてもカウントされません。ただし、プランごとに定められた月間のテスト実行回数上限が別途適用されます。実行時は対象のインシデントを1件選択し、結果は画面上にのみ表示されます（ダイアログを閉じると取得できなくなります）。
- **実行履歴の閲覧**: エージェントごとに、過去に実行された履歴を一覧で確認できます。
  - **一覧形式**: ページ形式で表示されます（エージェント単位の一覧では期間や状態による絞り込みは不可）。
  - **詳細ログの項目**: トリガー種別（イベント駆動/手動実行）、対象インシデント(リンク)、実行ステータス（実行中/承認待ち/完了/失敗/スキップ/承認期限切れ/却下）、開始日時・所要時間。実行失敗時はエラー内容、上限等によりスキップされた場合はその理由を確認できます。
- **総実行数の確認**: エージェントの通算の実行数を確認できます。
  - **総実行数**: 対象エージェントが実行された通算回数

## 制限事項

- **標準搭載エージェントの仕様制限**: 標準搭載エージェントの追加作成や削除はできません。また、名称、概要、判断内容、トリガー条件、実行アクションの内容を変更することもできません（有効/無効の切り替えと情報保護設定の変更のみ可能です）。独自の判断内容やアクションを持つエージェントを利用する場合は、カスタムエージェントを作成します。
- **Runbook 自動実行モードの非提供**: 標準エージェントは Runbook の実行提案や自動起動を行いません。また、カスタムエージェントが提案した Runbook の実行は必ず人による確認・承認が必要であり、人の承認を経ずに自動で外部ツールが実行されるモードは提供されていません。
- **削除データの復旧不可**: カスタムエージェントの削除は完全な削除であり、削除後に設定内容を復元することはできません。
- **カスタムエージェントの作成数と実行数の上限（プラン制限）**: カスタムエージェントの作成自体にはプランによる件数上限はありませんが、月間のAI実行数の上限は契約プランにより異なります（Starter は月10回まで。Standard・Enterprise は上限なし）。

## 関連機能

- [Rules の概要](/guides/rules/)（エージェントを自動起動させるインシデントポリシーの紐付け先）
- [Incidents / Tasks の概要](/guides/incidents-and-tasks/)（エージェントが分析・アクションを行う対象のインシデント）
- [Runbooks の概要](/guides/runbooks/)（カスタムエージェントが対処として提案する作業手順）
- [Integration の概要](/guides/integration/)（エージェントが参照する Sources と、外部サービスの調査に使う Access）
- [プラン・料金](/getting-started/plans-and-pricing/)（プランごとの月間 AI エージェント実行回数上限の詳細）