alibabacloud-sas-install-agent

セキュリティセンターエージェントのオンボーディングと管理

aliyun CLI を使用して、Alibaba Cloud Security Center エージェントのインストール、バージョン認証、アセットのクエリ、セキュリティリスクの検出を管理します。

アーキテクチャ：Security Center (SAS) + ECS + Cloud Assistant + Proxy Cluster (optional)

実行モデル：読み取り操作は直接実行します（ReAct）。書き込み操作は詳細を表示し、実行前にユーザーの確認を求めます（Command）。分析は簡潔にし、各アクションについて短い理由を示します。

事前確認：Aliyun CLI >= 3.3.3 が必要です aliyun version を実行して、バージョンが >= 3.3.3 であることを確認します。インストールされていない場合、またはバージョンが古い場合は、 curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash を実行してインストールまたは更新するか、 インストール手順については references/cli-installation-guide.md を参照してください。 次に、aliyun configure set --auto-plugin-install true を実行して、自動プラグインインストールを有効にする必要があります。 続けて、aliyun plugin update を実行し、ローカルマシンに既存のプラグインがある場合は、常に最新の状態にしてください。

事前確認：Alibaba Cloud の認証情報が必要です

セキュリティルール：

• 絶対に AK/SK の値を読み取ったり、エコーしたり、出力したりしないでください（例：echo $ALIBABA_CLOUD_ACCESS_KEY_ID は禁止です）
• 絶対に会話やコマンドラインで、AK/SK を直接入力するようユーザーに求めないでください
• 絶対に aliyun configure set にリテラルの認証情報を指定しないでください
• 認証情報の状態を確認するには、aliyun configure list のみを使用してください

aliyun configure list

出力を確認し、有効なプロファイル（AK、STS、または OAuth ID）があることを確認します。

有効なプロファイルが存在しない場合は、ここで停止してください。

1. Alibaba Cloud Console から認証情報を取得します
2. このセッションの外部で認証情報を設定します（ターミナルで aliyun configure を実行するか、シェルプロファイルに環境変数を設定します）
3. aliyun configure list に有効なプロファイルが表示された後、戻って操作を再実行します

セキュリティガイドライン

• 認証情報の漏えいによってアカウントが侵害されるおそれがあるため、機密情報（AccessKey、パスワード）を出力に含めないでください
• 削除操作は取り消せず、保護に支障をきたす可能性があるため、Delete クラスの API は呼び出さないでください
• 書き込み操作（インストールコードの作成、クラスターの作成、プロキシのインストール、Cloud Assistant 経由のコマンド実行、認証のバインド、スイッチの変更）は稼働中のリソースを変更するため、操作の詳細を表示し、実行前にユーザーの確認を待ってください
• Cloud Assistant 経由でコマンドを送信する前に、コマンドの内容全体を表示してください。これは、本番サーバーで任意のコマンドを実行することは高リスクであるためです

RAM ポリシー

このスキルに必要な詳細な権限：references/ram-policies.md

[MUST] 権限エラーへの対応： 実行中のどの時点でも、権限エラーによってコマンドまたは API 呼び出しが失敗した場合は、次の手順に従ってください。

1. references/ram-policies.md を読み、この SKILL に必要な権限の全一覧を確認します
2. ram-permission-diagnose スキルを使用して、必要な権限を申請する手順をユーザーに案内します
3. 必要な権限が付与されたことをユーザーが確認するまで待機します

IMPORTANT: パラメーターの確認 — コマンドまたは API 呼び出しを実行する前に、 ユーザーがカスタマイズできるパラメーター（例：RegionId、インスタンス名、CIDR ブロック、 パスワード、ドメイン名、リソース仕様など）は、すべてユーザーに確認する必要があります。 明示的な承認を得ずに、値を推測したりデフォルト値を使用したりしないでください。

コアワークフローの開始時（CLI を呼び出す前）： [MUST] AI モードを有効化する — エージェントスキルの実行には AI モードが必要です。 CLI を呼び出す前に、次のコマンドを実行します。

aliyun configure ai-mode enable
aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-sas-install-agent"

[MUST] あらゆる終了時点で AI モードを無効化する — 理由を問わず、最終応答を返す前に必ず AI モードを無効化してください。これは、ワークフローの成功、ワークフローの失敗、エラー／例外、ユーザーによるキャンセル、セッションの終了、その他 CLI コマンドをこれ以上実行しないあらゆる状況を含む、すべての終了経路に適用されます。 AI モードはエージェントスキルの呼び出し時にのみ使用し、スキルの実行停止後も有効なままにしてはなりません。

aliyun configure ai-mode disable

---

ツール一覧

すべての API は aliyun CLI を介して呼び出します。すべての aliyun コマンドには、必ず --user-agent AlibabaCloud-Agent-Skills/alibabacloud-sas-install-agent を含めてください。

CLI コマンド	用途
aliyun sas describe-cloud-center-instances	インスタンス ID／IP でサーバークライアントのステータスを照会
aliyun ecs describe-instances	ECS インスタンス情報と実行ステータスを照会
aliyun ecs describe-cloud-assistant-status	クラウドアシスタントがオンラインかどうかを確認
aliyun ecs run-command	リモートインストールコマンドを実行（書き込み）
aliyun ecs invoke-command	インスタンス上の既存コマンドを実行（書き込み）
aliyun ecs describe-invocation-results	コマンド実行結果を照会
aliyun sas refresh-assets	最新のアセットデータを同期
aliyun sas describe-install-codes	既存のインストールコード一覧を取得
aliyun sas add-install-code	新しいインストールコードを生成（書き込み）
aliyun sas create-or-update-asset-group	アセットグループを作成または更新（書き込み）
aliyun sas get-auth-summary	バージョンごとの認証クォータと使用状況を取得
aliyun sas describe-version-config	バージョン、機能モジュール、有効期限を取得
aliyun sas get-serverless-auth-summary	従量課金制のサーバーレスのステータスを取得
aliyun sas modify-post-pay-module-switch	従量課金制モジュールのスイッチを切り替え（書き込み）
aliyun sas bind-auth-to-machine	認証バージョンをバインド／バインド解除（書き込み）
aliyun sas update-post-paid-bind-rel	従量課金制のバージョンバインドを変更、または無料バージョンにダウングレード（書き込み）
aliyun sas describe-property-sca-detail	サーバー上のソフトウェア情報を照会
aliyun sas add-uninstall-clients-by-uuids	指定したサーバーからエージェントをアンインストール（書き込み）
aliyun sas modify-push-all-task	サーバーにセキュリティチェックタスクをディスパッチ（書き込み）—対象を単一サーバーに絞ったスキャンにはこれを使用
aliyun sas modify-start-vul-scan	すべてのサーバーを対象としたグローバルなフルスキャンを開始（書き込み）—対象を単一サーバーに絞ったスキャンには絶対に使用しない
aliyun sas describe-grouped-vul	グループ化された脆弱性統計を照会
aliyun sas exec-strategy	ベースラインチェック戦略を実行（書き込み）
aliyun sas describe-strategy	ベースラインチェック戦略の一覧を照会
aliyun sas list-check-item-warning-summary	ベースラインチェックのリスク統計を取得
aliyun sas describe-susp-events	セキュリティアラートイベントを照会
aliyun sas generate-once-task	アセットフィンガープリントの完全な収集を開始（書き込み）
aliyun sas create-asset-selection-config	ウイルススキャンのアセット選択を作成
aliyun sas add-asset-selection-criteria	選択設定にアセットを追加
aliyun sas update-selection-key-by-type	選択対象をウイルススキャンに関連付け
aliyun sas create-virus-scan-once-task	単発のウイルススキャンタスクを作成（書き込み）
aliyun sas get-virus-scan-latest-task-statistic	最新のウイルススキャンタスクの統計を照会
aliyun sas list-virus-scan-machine	ウイルススキャンの対象マシンを照会
aliyun sas list-virus-scan-machine-event	特定のマシン上のウイルスイベントを照会
aliyun sas describe-once-task	脆弱性スキャンタスクの進行状況をポーリング

API パラメーターの詳細：references/api-reference.md。RAM 権限：references/ram-policies.md。コマンド一覧：references/related-commands.md。

---

共通フロー：インストールコードの取得または作成

インストールコードが必要なインストールシナリオでは、次の共通フローに従います。

ステップ 1：既存のインストールコードを照会する

aliyun sas describe-install-codes --user-agent AlibabaCloud-Agent-Skills/alibabacloud-sas-install-agent

表形式で表示します：インストールコード、OS、ベンダー、グループ、イメージフラグ、有効期限。

ステップ 2：ユーザーに選択してもらう

ユーザーは、有効期限内で条件に合う既存のコードを選択するか、新しいコードの作成をリクエストできます。

ステップ 3：新しいインストールコードの設定を確認する（作成する場合のみ）

設定	パラメーター	備考
OS	--os	linux または windows
ベンダー	--vendor-name	ネットワークアクセス方法によって決まります（以下を参照）
アセットグループ	--group-id	対象グループ。必要に応じて create-or-update-asset-group で作成します
有効期限	--expired-date	13 桁のタイムスタンプ。省略した場合はデフォルト値が適用されます
イメージインストール	--only-image	イメージテンプレートの作成に使用するかどうか

VendorName とネットワークアクセス方法の対応：

ベンダーパラメーターによって、インストールコマンドが使用する接続ドメインが決まります。値を間違えると、エージェントはサーバーに接続できません。

ネットワークアクセス	VendorName	理由
専用回線（専用線）	ALIYUN	内部ドメイン jsrv2.aegis.aliyun.com を使用します
パブリックネットワーク（Alibaba Cloud ECS）	ALIYUN	ECS は内部ネットワークを使用します
パブリックネットワーク（サードパーティクラウド／IDC）	OTHER	パブリックドメイン jsrv.aegis.aliyun.com を使用します

シナリオですでにネットワークアクセス方法が特定されている場合は、ユーザーに確認せず VendorName を自動入力します。

確認後、作成を実行します（ユーザーが指定したパラメーターのみを渡します）。これは確認が必要な書き込み操作です。

ステップ 4：インストールコマンドを取得する

作成後、インストールコードの一覧を再照会し、新しい CaptchaCode を取得してインストールコマンドを作成します。

---

シナリオの振り分け

シナリオ 0：初回相談

トリガー：ユーザーが「Security Center に登録したい」「セキュリティエージェントをインストールしたい」「クラウドセキュリティをデプロイしたい」など、曖昧な要望を伝えた場合。

方針：ツールは呼び出さず、質問で情報を収集してから振り分けます。

1. サーバーの種類：

   • Alibaba Cloud ECS → シナリオ 1
   • サードパーティクラウド／オンプレミス IDC → 質問 2 に進みます

2. ネットワークアクセス方法：

   • パブリックネットワークまたは専用線での直接接続 → シナリオ 2

3. イメージのデプロイ → シナリオ 3

---

シナリオ 1：Alibaba Cloud ECS の登録

トリガー：サーバーが Alibaba Cloud ECS インスタンスであるとユーザーが確認した場合。

概要：

1. ECS 情報を取得し、インスタンスとクライアントのステータスを照会します
2. ClientStatus と ClientSubStatus に基づいて処理します：オンライン＝対応不要、未インストール＝インストール、オフライン＝トラブルシューティング
3. インストールコードを取得または作成します（共通フロー）
4. クラウドアシスタントがオンラインの場合はリモートで実行し、そうでない場合は手動インストールコマンドを提示します
5. 登録を確認します

詳細な手順と CLI コマンド：references/install-scenarios.md#scenario-1-alibaba-cloud-ecs-onboarding

---

シナリオ 2：オンプレミス IDC への直接接続（パブリックネットワーク／専用線）

トリガー：オンプレミス IDC またはサードパーティクラウドのサーバーが、パブリックネットワークまたは専用線で接続されている場合。

概要：

1. インストールコードを取得または作成します（共通フロー。VendorName はネットワークの種類に応じて自動決定されます）
2. ネットワーク状況（パブリックネットワーク／専用線／海外）に応じてインストールコマンドを選択します。references/agent-install-guide.md を参照してください
3. 登録を確認します

詳細な手順：references/install-scenarios.md#scenario-2-on-premises-idc-direct-connection

シナリオ 3：イメージを使用した一括インストール

トリガー：ユーザーがイメージのデプロイ、エージェントを事前インストールしたサーバーの一括作成、テンプレートの作成について言及した場合。

概要：

1. テンプレートサーバーの情報を確認し、クリーンな環境が必要であることを伝えます
2. イメージ専用のインストールコードを取得または作成します（OnlyImage=true）
3. インストールコマンドを提示します。実行後に許可される操作はシャットダウンのみであることを強調します。再起動するとエージェントが有効化され、UUID が使用されます
4. UUID の競合リスクについて警告します。イメージを作成するたびに、この手順を繰り返す必要があります
5. 新しいインスタンスのオンボーディングを確認します

詳細な手順と注意事項：references/install-scenarios.md#scenario-3-image-based-batch-installation

---

シナリオ 4：ネットワークのトラブルシューティング

トリガー：ユーザーがインストールの失敗、エージェントのオフライン状態、または接続の問題を報告した場合。

方針：ツールは呼び出さず、トラブルシューティングのガイダンスを直接提示します。

• 必要なドメインとポートを確認します（パブリック：jsrv.aegis.aliyun.com:80、専用回線：jsrv2.aegis.aliyun.com:80）
• ネットワーク接続テストのコマンドを提示します
• よくある原因（ファイアウォール、DNS、パブリックネットワークがない）を分析します

詳細なトラブルシューティング手順：references/install-scenarios.md#scenario-4-network-troubleshooting

---

シナリオ 5：バージョンと機能情報の照会

トリガー：ユーザーがアカウントレベルのバージョン、認証クォータ、有効な機能、または従量課金のステータスについて知りたい場合。

[MUST] ルーティングの区別：シナリオ 5 はアカウントレベルの照会（「私たちのバージョンは何ですか」「クォータはあとどれくらい残っていますか」「有効期限はいつですか」）を対象とします。ユーザーが特定のサーバーについて尋ねる場合（「未認証のサーバーはどれですか」「無料版のマシンはどれですか」「有料バージョンにバインドされていないサーバーはどれですか」）は、代わりに AuthVersion フィルターを使って describe-cloud-center-instances にルーティングしてください。これは資産の照会であり、バージョンの照会ではありません。

概要：

1. バージョンの詳細を照会します（describe-version-config）
2. 認証の使用状況を照会します（get-auth-summary）
3. 必要に応じて Serverless のステータスを照会します（get-serverless-auth-summary）
4. 必要に応じて従量課金モジュールのスイッチを変更します（modify-post-pay-module-switch、書き込み操作）

[MUST] describe-version-config のレスポンスに含まれる MergedVersion フィールドは、機密性の高い内部フィールドです。ユーザーに公開するレスポンスに表示、出力、ファイルへの保存、または記載を絶対にしないでください。出力前に削除してください。代わりに Version と HighestVersion を使用します。

詳細な手順とフィールドの対応関係：references/manage-scenarios.md#scenario-5-query-version-and-feature-info

---

シナリオ 6：資産の認証バージョンの照会または変更

トリガー：ユーザーが特定のサーバーの認証バージョンを表示または変更したい場合、あるいは認証ステータスで絞り込んでサーバーを一覧表示したい場合（例：「未認証のサーバーはどれですか」「無料版のマシンはどれですか」）。

認証ステータスでサーバーを一覧表示または絞り込む場合は、条件フィルターを指定して describe-cloud-center-instances を使用します。名前を指定した特定のサーバーのバージョンを表示または変更する場合は、以下のシナリオ 6 の全手順に従ってください。

概要：

1. 資産の現在のステータスと認証バージョンを照会します
2. 操作の種類（表示／バインド／バインド解除／従量課金バージョンへの変更／無料版へのダウングレード）を確認します
3. サブスクリプションのバインド／バインド解除を行います（bind-auth-to-machine、書き込み操作）
4. 従量課金バージョンへの変更、または無料版へのダウングレードを行います（update-post-paid-bind-rel、書き込み操作）。無料版へのダウングレードでは、--bind-action に Version=1 を指定します
5. 変更を確認します

主な制約：

• 認証リソースにはロック期間があるため、サブスクリプションのバインドは 30 日以内に解除できません
• K8s/ACK クラスター資産でサポートされるのは Ultimate エディションのみです。他のエディションではコンテナーランタイム保護がカバーされないためです

詳細な手順：references/manage-scenarios.md#scenario-6-query-or-modify-asset-authorization

---

シナリオ 7：特定のソフトウェアがインストールされた資産の照会

トリガー：ユーザーが特定のソフトウェアのインストールされたサーバーを見つけたい場合。

概要：

1. 照会条件（ソフトウェア名、種類）を確認します
2. 資産フィンガープリントを照会します（describe-property-sca-detail）
3. 必要に応じて、詳細な資産情報を補足します

詳細な手順：references/manage-scenarios.md#scenario-7-query-assets-with-specific-software

---

シナリオ 8：Security Center エージェントのアンインストール

トリガー：ユーザーが特定のサーバーから Security Center エージェントをアンインストールしようとしています。

概要：

1. 対象サーバーの識別子を取得し、アセット情報を照会して UUID を取得します
2. アンインストールの詳細（サーバー名、UUID、現在のステータス）を表示し、アンインストールするとすべての保護機能が削除されることを警告します
3. 確認後、アンインストールを実行します（add-uninstall-clients-by-uuids、書き込み操作）
4. アンインストール結果を確認します

主な制約：

• この API は Alibaba Cloud 以外のサーバー（IDC／サードパーティーのクラウド）に適用されます。Alibaba Cloud ECS のアンインストールには、コンソールまたはクラウドアシスタントが必要です
• アンインストールすると Security Center のすべての保護機能が削除されるため、ユーザーによる明示的な確認が必要です

詳細な手順：references/manage-scenarios.md#scenario-8-uninstall-security-center-agent

---

シナリオ 9：セキュリティリスクの検出と照会

トリガー：ユーザーがセキュリティリスクの検出、脆弱性スキャンの実行、ベースラインチェックの実行、セキュリティアラートの表示、またはリスク結果の取得を希望しています。

概要：

1. 検出の種類を確認します（既存のリスク結果を照会する／新しいスキャンを実行する）
2. リスク結果を照会します：脆弱性（describe-grouped-vul）、ベースライン（list-check-item-warning-summary）、セキュリティアラート（describe-susp-events）
3. 新しいスキャンを実行します — 明確に異なる 2 つのモードがあります：
   • 対象を指定したスキャン（特定のサーバー）：すべてのスキャン種別（脆弱性＋ベースライン＋フィンガープリント）で、対象の UUID を指定して modify-push-all-task を使用します。対象を指定したスキャンでは、modify-start-vul-scan は絶対に使用しないでください。
   • 全体スキャン（すべてのサーバー）：脆弱性には modify-start-vul-scan、ベースラインには exec-strategy、フィンガープリントには generate-once-task、ウイルスには create-virus-scan-once-task を使用します
4. 対象アセットのスキャンでは、前提条件のチェーンを自動的に実行します：認可の確認 -> クライアントの確認 -> 自動インストール -> スキャンとウイルススキャンのディスパッチ
5. ディスパッチ後、進捗をポーリングします：脆弱性スキャン（describe-once-task）、ベースラインチェック（describe-strategy.ExecStatus）、ウイルススキャン（get-virus-scan-latest-task-statistic）。すべて完了したらリスク結果を照会します

主な制約：

• [HARD GATE] 対象を指定したスキャンでは modify-start-vul-scan を絶対に使用しないでください：modify-start-vul-scan は、対象のサーバーだけでなく、アカウント全体のすべてのサーバーを対象とする全体スキャンを開始します。特定のサーバーをスキャンする場合（対象を指定したスキャン）は、サーバーの UUID を指定して modify-push-all-task を使用する必要があります。これは、対象を指定した脆弱性スキャンで使用できる唯一の正しいコマンドです。modify-start-vul-scan は、特定の対象が指定されていない全体スキャンの場合に限り使用します。
• [HARD GATE] すべてのスキャンでクライアントがオンラインである必要があります：すべてのスキャンディスパッチ操作（modify-push-all-task、modify-start-vul-scan、exec-strategy、create-virus-scan-once-task）はホストベースであり、対象サーバーの Security Center エージェントの ClientStatus=online が必要です。エージェントがインストールされていない、またはオフラインの場合、スキャンをディスパッチできず、結果も生成されません。このスキルにはエージェントレスのスキャンモードはありません。クライアントがオンラインでない場合は、スキャンのディスパッチを進めず、まずエージェントをインストールするか、オンラインにするようユーザーに案内してください
• [HARD GATE] スキャンには有料の認可が必要です：対象サーバーには有料の認可バージョン（AuthVersion > 1）がバインドされている必要があります。無料バージョン（AuthVersion <= 1）のサーバーはスキャンできません
• 既存のリスク結果の照会（describe-grouped-vul、list-check-item-warning-summary、describe-susp-events）は、Security Center のデータベースにある過去のデータを照会する読み取り操作です。新しいスキャンは実行されず、エージェントがオンラインである必要もありません
• 全体スキャンの前に、すべてのアセットのステータスを照会し、準備完了／未準備のアセットの内訳をユーザーに提示してから、ディスパッチ前に確認を取ってください
• 対象アセットのスキャンでは、前提条件のチェーン（認可＋クライアント）が完全に自動化されています。ユーザーの確認が必要なのは認可のバインドのみです
• ベースライン検出（HEALTH_CHECK / exec-strategy）には、有料のホスト保護バージョン（Version > 1）または Cloud Security Posture Management（CSPM）の有効化が必要です。いずれも満たされない場合は、ベースライン検出をスキップしてください
• スキャン操作は書き込み操作です。全体スキャンを実行する前には確認が必要です

詳細な手順：references/manage-scenarios.md#scenario-9-security-risk-detection-and-query

---

フォールバックシナリオ

トリガー：該当するシナリオがない場合、またはリクエストがこのスキルの対応範囲を超える場合です。

方針：現時点では対応していないことをユーザーに正直に伝え、公式ドキュメントの参照またはサポートチケットの提出を案内してください。

---

実行ルール

読み取り操作（直接実行）

describe-cloud-center-instances、describe-instances、describe-cloud-assistant-status、describe-invocation-results、describe-install-codes、refresh-assets、get-auth-summary、describe-version-config、get-serverless-auth-summary、describe-property-sca-detail、describe-grouped-vul、list-check-item-warning-summary、describe-susp-events、describe-strategy、get-virus-scan-latest-task-statistic、list-virus-scan-machine、list-virus-scan-machine-event、describe-once-task

呼び出しの前に、意図を簡潔に（1～2文で）説明してください。

書き込み操作（実行前に確認）

add-install-code、run-command、invoke-command、create-or-update-asset-group、modify-post-pay-module-switch、bind-auth-to-machine、update-post-paid-bind-rel、add-uninstall-clients-by-uuids、modify-push-all-task、modify-start-vul-scan、exec-strategy、generate-once-task、create-asset-selection-config、add-asset-selection-criteria、update-selection-key-by-type、create-virus-scan-once-task

フロー：操作の詳細を表示 -> ユーザーの確認を待つ -> 実行 -> 結果を報告

確認フェーズ

• 返された結果を簡潔に説明する
• 期待どおりかどうかを判断する
• 次のアクションを決定する

反復の原則

1. エージェントがすでにオンラインの場合は、対応が不要であることをすぐにユーザーに伝える
2. シナリオごとの CLI ツール呼び出しは8回までに制限する（プロキシのシナリオでは適度に増やしてもかまいません）
3. サーバー情報が確認できていない状態で API を呼び出さない。誤ったパラメーターでは意味のない結果が返されるため
4. 各ステップの出力が次のステップの入力になるため、手順を省略しない
5. API の戻り値を捏造しない。ユーザーを誤った判断に導くおそれがあります

コスト見積もりのルール

• 従量課金モジュールのステータスを表示する際は、各モジュールの課金方式と単価の参照情報を含める
• ユーザーが従量課金モジュールを有効にする前に、確認内容にコストの見積もりを含める
• 料金は公式の課金ドキュメントページから取得する：https://help.aliyun.com/zh/security-center/product-overview/billing-overview
  • セッション中、料金が初めて必要になったときに一度取得し、その後は再利用する
  • 取得できない場合は、ユーザーが確認できるよう課金ページへのリンクを提示する
• 基本サービス料金：従量課金モジュールを有効にすると、基本サービス料金が適用されます（約0.05 CNY/時間、月額約36 CNY）
  • 現在有効なモジュールがない場合、最初に有効化するときにこの料金についてユーザーに注意を促す

モジュールの分類、見積もりの計算式、表示形式については、references/manage-scenarios.md のコスト見積もりのセクションを参照してください。

---

終了と要約

次のいずれかの条件を満たした場合、要約に進みます：

• エージェントが正常にオンラインになった
• インストールコマンドをユーザーに提示した
• バージョン／認証／ソフトウェア情報を照会して表示した
• 認証のバインド／解除／変更操作が完了した
• エージェントのアンインストール操作が完了した
• セキュリティリスクの検出が完了した、またはリスクの結果を表示した
• 問題を特定し、解決策を提示した
• シナリオがサポート対象外であり、サポートチケットの作成を推奨した

要約の形式はシナリオに応じて調整します。主な項目は、操作結果、重要情報（サーバー／バージョン／ステータス）、フォローアップの推奨事項です。

---

ベストプラクティス

1. 操作を行う前に、必ず CLI のバージョンと認証情報を確認する
2. 接続障害を避けるため、ネットワークアクセス方式に応じて正しい VendorName を使用する
3. 一括インストールでは、手作業を減らすため、イメージベースの方法を優先する
4. 上限を超過しないよう、新しいサーバーをバインドする前に認証枠を確認する
5. オフラインのエージェントをトラブルシューティングする際は、まず Security Center エンドポイントへのネットワーク接続を確認する
6. プロキシのシナリオでは、続行する前にプロキシサーバーが要件（Linux、ポート80／443／8080）を満たしていることを確認する
7. タスクの完了と判断する前に、インストール後のエージェントのオンラインステータスを必ず確認する

---

参考資料

このスキルでは、必要に応じて以下のドキュメントを読み込みます。

参考資料	説明
references/install-scenarios.md	インストールシナリオ（1、2、3、4）の詳細な実行手順
references/manage-scenarios.md	管理／クエリシナリオ（5、6、7、8、9）の詳細な実行手順
references/agent-install-guide.md	エージェントのインストールコマンドと検証方法
references/api-reference.md	すべての API パラメーターの詳細と CLI の例
references/ram-policies.md	RAM 権限マニフェスト
references/cli-installation-guide.md	Alibaba Cloud CLI のインストールガイド
references/related-commands.md	CLI コマンドの完全なリファレンス表
references/verification-method.md	各シナリオの成功確認方法
references/acceptance-criteria.md	スキルの受け入れ基準とテストパターン