ae-engage

ae-engage

AE CLI（ae-cli）は、AI エージェントと人間のユーザーが使用する、Agentic Engine データ分析プラットフォームのコマンドラインツールです。

機能の契約

• 責務：エンゲージメントチャネル、設定、戦略、タスクの下書き／ライフサイクル、フロー、アクティビティ、およびそれらのレポート／クエリのライフサイクル。
• 入力：検証済みのプロジェクト／リソース識別子と、操作ごとの設定です。既知のオーディエンス／イベント／プロパティ定義を再利用し、選択した操作で必要な場合に限り、不足している前提条件を確認します。
• 出力：設定／タスク／リソースの識別子、レポート、または実際に永続化された状態を示すクエリ／実行ステータスです。下書きを保存しても、承認の申請や配信は開始されません。
• 境界：一般的な分析、メタデータの検出、単独でのオーディエンス作成は、それぞれ別の機能です。すべてのエンゲージメント依頼で、これらを事前に必ず実施する必要はありません。
• 完了：ユーザーが依頼したエンゲージメント操作が検証されるか、保留中／ブロック中の作業が報告されます。下書きの作成、承認の申請、送信はそれぞれ別の操作であり、個別のユーザーの意図が必要です。

スキル間の連携

残りの作業がこのスキルの範囲外である場合、または必要な前提条件に別の機能が必要な場合は、連携プロトコルに従ってください。今回の実行で利用可能なスキルから、機能に基づいて選択し、検証済みのコンテキストを保持して、残りのタスクを続行します。このプロトコルがすでに読み込まれている場合は、再利用してください。

AE CLI の全般的なルール

AE CLI（ae-cli）は、AE（Agentic Engine）分析プラットフォームのコマンドラインツールです。AE の分析に関する依頼では、モデルの記憶よりも ae-cli とこのスキルのリファレンスドキュメントを優先してください。

グローバルパラメーター：

パラメーター	説明
--format <json|table>	出力形式です。デフォルトは JSON です。
--jq <expr>	JSON 出力用の jq フィルター式です。
--host <url>	アクティブな AE ホストを上書きします。すべてのコマンドで使用でき、サブコマンドの後に指定することもできます。例：ae-cli engage-flow flow list --host <url>。

出力とエラー：

• コマンドが成功すると、デフォルトで機械可読な JSON が返されます。エンベロープには任意の _notice.host_compat が含まれる場合があります。
• コマンドが失敗すると、{ "ok": false, "error": { "type": "...", "message": "...", "hint": "..." } } が返され、ゼロ以外の終了コードで終了します。
• 重要 — ホスト互換性（最初に実施）： ae-cli を実行するたびに、stderr と _notice.host_compat を確認してください。どちらかが存在する場合は、ユーザーへの返信の冒頭で短い⚠️バージョン警告を示し、npm i -g／npx skills add（または update-cluster）の行を一字一句そのまま引用してから、処理結果を提示してください。これはソフトな注意喚起です。ok: true でも通知が含まれる場合があります。

安全性に関する制約：

• 必要な ID と参照先を確認した後、読み取りコマンドは直接実行できます。
• 書き込みコマンドには、ユーザーの明示的な意図が必要です。通常の write コマンドは CLI の確認なしで実行されます。確認ゲートを使用するのは high-risk-write コマンドのみです。
• コマンド名、フラグ、JSON ペイロード、project_id、リソース ID、フィールド名、イベント名、プロパティ名、指標の定義、日付形式を決して捏造しないでください。該当するコマンドのリファレンスを読み、実在するプロジェクトメタデータを先に確認してください。
• リソース名（レポート、ダッシュボード、イベント、プロパティ、指標、クラスター、タグ、アラート）を決して捏造したり推測したりしないでください。 必ずリストコマンドを使って、実在するリソースを先に確認してください。あいまい検索と全件リストへのフォールバックを行ってもリソースが見つからない場合は、ユーザーに「resource not found」と明確に伝えて停止し、捏造した名前で処理を続けないでください。

概要

ae-engage パッケージは、設定項目、フロー、チャネル設定、タスクデータ、クエリのライフサイクル全体にわたって、Hermes Engage の機能を提供します。ae-cli engage-flow|engage-task|engage-setting|engage-scene|engage-query <resource> <action> を通じて capability-gateway コマンドを使用してください。低頻度のレポートについては、以下の L3 リファレンスを参照してください。

主なユースケースは次のとおりです。

• チャネル、設定チャネル、承認者、許可リストの照会と管理
• プロジェクトのチャネル接触上限または配信疲れ制御ルールの照会
• タスクリスト、タスクの詳細、実験レポート、指標レポートの照会
• 設定項目や戦略の照会、テンプレートのコピー、戦略のステータス管理
• フローリスト、ノードスキーマ、フローレポートの照会、フローの保存や管理

キーワードルーティング

ユーザーが以下の製品用語（一般的な中国語の UI ラベルを含む）に言及した場合、推測でコマンドや ID を判断せず、まず記載されたリファレンスを開いてください。

キーワード	製品上の意味	CLI ドメイン	主なリファレンス	関連リファレンス
Config center	Engage のシーン管理／設定センターの概要	engage-scene	references/scene-config-item.md	scene-config-param.md、scene-config-group.md、scene-preset-metric.md、scene-config-metric.md、scene-config-channel.md、channel-mgmt.md、scene-strategy.md、scene-template.md；L3 レポート：config-item-trigger-report.md、config-item-analysis-report.md、config-item-strategy-comparison.md
Scene config	設定センターと同じです。設定項目の下にあるパラメーター、グループ、メトリクス、チャネル、戦略、テンプレートを指します	engage-scene	references/scene-config-item.md	上記と同じです。パラメーター／グループ／メトリクス：scene-config-param.md、scene-config-group.md、scene-preset-metric.md、scene-config-metric.md
Config item	設定センター内の単一の設定項目	engage-scene	references/scene-config-item.md	scene-config-param.md、scene-preset-metric.md、scene-config-metric.md、scene-strategy.md、scene-template.md
Push channel	プロジェクトレベルのメッセージプッシュチャネル（Webhook、FCM、APNS など）	engage-setting	references/channel-list.md	channel-detail.md、add-channel.md（Webhook と Client は異なります：url は HTTP とシーンキーで異なり、カスタムパラメーターは user: と user:／client: で異なります）、update-channel-status.md、delete-channel.md、channel-update-config.md、channel-test-send.md、channel_touch_limits_list.md
Config channel	設定センターの Webhook／クライアント設定チャネル（プッシュチャネルとは別のもの）	engage-scene	references/scene-config-channel.md	channel-mgmt.md（作成／有効化・無効化／コピー／削除のワークフロー）。config.customsParamList のユーザーパラメーターには、user: 接頭辞を付けた columnName が必要です（例：user:#account_id）。検証済みのプロパティ名を再利用するか、プロパティ検索機能を確認してください。
Operation strategy	設定項目の下にある運用／配信戦略	engage-scene	references/scene-strategy.md	カスタムオーディエンス：scene-strategy-audience.md — セマンティックな definitionRequest（Analysis の条件形式）を使用してください。targetClusterQp／qp は渡さないでください。プロパティを事前確認し、不足している場合は停止して一覧を取得してください。テンプレート：scene-template.md
Operation task	Hermes のプッシュ／エンゲージメントタスク（一覧表示、保存、ライフサイクル、レポート）	engage-task	references/task-list.md	task-detail.md（取得）、save-task.md、build-task-save-guide.md、task-stats.md、task-delete.md、push-record-query.md、task-user-detail-export.md、task-indicator-user.md、task-data-overview.md、task-data-detail.md、task-metric-detail.md、task-metric-update.md、task-experiment-report.md
Operation activity	キャンペーンアクティビティの管理、およびアクティビティ、トピック、単独タスクごとの配信傾向	engage-activity	references/activity-activity.md	activity-data-detail.md、activity-topic.md、activity-task.md、activity-approval.md
Template	設定項目の下にある戦略テンプレート	engage-scene	references/scene-template.md	scene-config-param.md（テンプレートフィールドは paramId を参照します）。戦略を作成する前に、template update を実行し、続けて template update-status で有効化してください

混同しやすい項目：

• Push channel → ae-cli engage-setting channel …（Hermes のプッシュチャネル設定）
• Config channel → ae-cli engage-scene config-channel …（設定センターのチャネル。channel-mgmt.md を参照）
• Flow／Task のキャンバスノードは push channels の channelId を使用します。設定項目は config channels の channel_id をバインドします

パラメーターの規則

• シンプルなパラメーターには通常のフラグを使用します。例：--project-id、--task-id、--flow-uuid
• 配列パラメーターには JSON フラグを使用します。例：--strategy-uuid-list '["id1","id2"]'
• オブジェクトパラメーターには名前付き JSON フラグを使用します。例：--req '{...}'、--flow-list '[...]'
• オプションのグローバルパラメーターは、ほかのドメインと同じように機能します。例：--host、--mcp-url、--dry-run

命名規則の境界：

• CLI フラグにはケバブケースを使用します。外側の Capability 入力と、すべての Capability レスポンスキーにはスネークケースを使用します。
• --req または --payload を介して渡すネストされたビジネス DTO では、ドキュメントに記載されたネイティブのキャメルケースのフィールドを維持します。ネストされた DTO キーを機械的にスネークケースに変換しないでください。
• 意味上のオーディエンス、イベント、トリガー、完了、メトリックの定義は、閉じたコントラクトです。CLI は不正な形式または未知の意味フィールドをローカルで拒否します。書き込みを行わない --validate でも、同じ厳密な Hermes Capability スキーマが適用されます。
• 移行後のコマンドが成功すると、ビジネスのペイロードは data の下に返されます。フィールドを選択する前に、対応するリファレンスの Response 形式を確認してください。

JSON パラメーター形式

一般的な JSON フラグの例：

--provider-list '["webhook","fcm"]'
--strategy-uuid-list '["strategy_a","strategy_b"]'
--flow-id-list '["flow_1","flow_2"]'
--req '{"pageNum":1,"pageSize":20}'

よくあるシナリオ

1. 設定

# Query the channel list
ae-cli engage-setting channel list --project-id 1

# Filter by provider
ae-cli engage-setting channel list --project-id 1 --provider-list '["webhook","fcm"]'

# Query config channels (config center channel management — use engage-scene, not legacy +config_channel_*)
ae-cli engage-scene config-channel list --project-id 1 --channel-type 0

# Query project channel touch-limit rules
ae-cli engage-setting channel-touch-limits list --project-id <project_id>

# Update a channel's config / reach-funnel settings
ae-cli engage-setting channel update-config --project-id <project_id> --channel-id <channel_id> --enable-touch-event 1

# Send a test message to a channel
ae-cli engage-setting channel test-send --project-id <project_id> --channel-id <channel_id> --push-id <send_id> --content-list '[{"key":"title","value":"hello"}]'

# Batch update / toggle / save channel touch-limit (fatigue-control) rules
ae-cli engage-setting channel-touch-limits batch-update --project-id <project_id> --items '[{"rule_id":"r1","enable":true,"rule_def":"[]"}]'
ae-cli engage-setting channel-touch-limits toggle --project-id <project_id> --rule-id <rule_id> --enable false
ae-cli engage-setting channel-touch-limits save --project-id <project_id> --channel-biz-type <biz_type> --rule-def '[]' --enable true

# Remove an approver from a project
ae-cli engage-setting approval-approver delete --project-id <project_id> --approver <open_id> --yes

# Whitelist add / update / delete / verify
ae-cli engage-setting whitelist add --project-id <project_id> --prop-code <prop_code> --column-name <column_name> --column-type string --whitelist-list '[{"entity_id":"u1","source_value":"v1"}]'
ae-cli engage-setting whitelist update --project-id <project_id> --whitelist-id <id> --note-name <name>
ae-cli engage-setting whitelist delete --project-id <project_id> --whitelist-ids '["wl-1"]' --yes
ae-cli engage-setting whitelist verify --project-id <project_id> --prop-code <prop_code> --column-type string --whitelist-prop-list '["v1"]'

# Push-language (localization) get / set
ae-cli engage-setting push-language get --project-id <project_id>
ae-cli engage-setting push-language set --project-id <project_id> --push-language-column <prop_code>

# Client param update / delete / list
ae-cli engage-setting client-param create --project-id <project_id> --column-name level --column-type varchar --column-desc Level
ae-cli engage-setting client-param update --project-id <project_id> --column-name level --column-desc Level
ae-cli engage-setting client-param delete --project-id <project_id> --column-name level --yes
ae-cli engage-setting client-param list --project-id <project_id>

# Config table upload / save / list / query-data / update-data / delete
ae-cli engage-setting config-table upload --project-id <project_id> --request-id <rid> --file-name data.csv --file-content "$(base64 -i data.csv)"
ae-cli engage-setting config-table save --project-id <project_id> --request-id <rid> --info-name <table_name>
ae-cli engage-setting config-table list --project-id <project_id>
ae-cli engage-setting config-table query-data --project-id <project_id> --info-id <info_id>
ae-cli engage-setting config-table update-data --project-id <project_id> --request-id <rid> --info-name <table_name> --info-id <info_id>
ae-cli engage-setting config-table delete --project-id <project_id> --info-id <info_id> --yes

# Preset event list / update
ae-cli engage-setting preset-event list --project-id <project_id>
ae-cli engage-setting preset-event update --project-id <project_id> --add-event-definition '<semantic_event_json>'

# Common metric list / get / create / update / delete
ae-cli engage-setting common-metric list --project-id <project_id>
ae-cli engage-setting common-metric get --project-id <project_id> --metric-name <name>
ae-cli engage-setting common-metric create --project-id <project_id> --metric-type 1 --metric-name <name> --metric-definition '<semantic_metric_json>' --metric-window-num 1 --metric-window-time-unit day --display-name <display>
ae-cli engage-setting common-metric update --project-id <project_id> --metric-type 1 --metric-name <name> --metric-definition '<semantic_metric_json>' --metric-window-num 1 --metric-window-time-unit day --display-name <display>
ae-cli engage-setting common-metric delete --project-id <project_id> --metric-name <name> --yes

2. タスク

# Query the task list
ae-cli engage-task task list --project-id 1 --req '{"pageNum":1,"pageSize":20}'

# Build a save_task guide before composing the final req
ae-cli engage-task task build-save-guide --project-id 1 --req '{"context":{"triggerType":2,"channelId":"channel_123"}}'

# Save a task draft (create when req.taskId is omitted)
ae-cli engage-task task save --project-id 1 --req '{"baseInfo":{"taskName":"Demo Task"},"channelConfig":{"channelType":1,"channelId":"channel_123","groupContentList":[{"contentList":[{"pushLanguageCode":"default","content":"[]"}]}]},"targetConfig":{"targetClusterType":3},"triggerConfig":{"triggerType":2},"controlConfig":{"completionIndicatorDef":{"completionIndicators":[]}}}'

# Query task details
ae-cli engage-task task get --project-id 1 --task-id task_123

# Submit a saved draft task for approval
ae-cli engage-task task submit-approval --project-id 1 --task-id task_123

# Query task reports through the Hermes inline task-data capabilities
ae-cli engage-task effect query --project-id 1 --task-id task_123 --start-time 2026-04-01 --end-time 2026-04-07 --metric-id-list '["metric_1"]'
ae-cli engage-task data-detail query --project-id 1 --task-id task_123 --detail-type time --start-time 2026-04-01 --end-time 2026-04-07
ae-cli engage-task indicator-user sql --project-id 1 --task-id task_123 --indicator main --start-time 2026-04-01 --end-time 2026-04-07
ae-cli engage-task indicator-user run --project-id 1 --task-id task_123 --indicator secondary --secondary-index 1 --start-time 2026-04-01 --end-time 2026-04-07 --limit 100
ae-cli engage-task indicator-user export --project-id 1 --task-id task_123 --indicator metric --metric-id metric_1 --source metric --start-time 2026-04-01 --end-time 2026-04-07 --artifact-format csv

L3 タスクレポートの場合は、実行前に references/task-data-overview.md、references/task-data-detail.md、 references/task-metric-detail.md、または references/task-experiment-report.md をお読みください。 engage-task indicator-user を使用する前に、references/task-indicator-user.md をお読みください。グループ化、 指標、概要／詳細、メトリック、実験、タイムゾーンのフラグには、条件付きの互換性ルールがあります。

3. 設定

# Query the config item list
ae-cli engage-scene config-item list --project-id 1

# Query the strategy list
ae-cli engage-scene strategy list --project-id 1 --config-id cfg_123

L3 設定レポートの場合は、実行前に references/config-item-trigger-report.md、 references/config-item-analysis-report.md、または references/config-item-strategy-comparison.md をお読みください。

4. フロー

# Query the flow list
ae-cli engage-flow flow list --project-id 1

# Query flow details
ae-cli engage-flow flow get --project-id 1 --flow-uuid flow_uuid_123

# Query flow operation records and application logs
ae-cli engage-flow operation-log query --project-id 1 --flow-id flow_id_123

# Query flow versions and task push records
ae-cli engage-flow version list --project-id 1 --flow-id flow_id_123
ae-cli engage-flow flow update-remark --project-id 1 --flow-uuid flow_uuid_123 --flow-version-desc "Second version"
ae-cli engage-task operation-log query --project-id 1 --task-id task_id_123
ae-cli engage-task push-record query --project-id 1 --task-id task_id_123 --page-num 1 --page-size 20
ae-cli engage-task user-detail export --project-id 1 --task-id task_id_123 --task-instance-id instance_123 --user-status fail --artifact-format csv
ae-cli engage-task segment-list query --project-id 1 --task-id task_id_123
ae-cli engage-task group list --project-id 1
ae-cli engage-task metric list --project-id 1 --task-id task_id_123
ae-cli engage-task channel-ref stats --project-id 1 --channel-id channel_123
ae-cli engage-task task delete --project-id 1 --task-id task_id_123 --yes
ae-cli engage-task task submit-approval --project-id 1 --task-id task_id_123

# Query the node schema
ae-cli engage-flow node-config schema --project-id 1 --node-type message_push
ae-cli engage-flow metric update --project-id 1 --flow-id flow_id_123 --metric-map '<metric_map_json>'

# Query or export newly exposed flow report surfaces
ae-cli engage-flow report metric-detail run --project-id 1 --flow-id flow_id_123 --node-uuid node_uuid_123 --start-time 2026-04-01 --end-time 2026-04-07 --limit 100 --timeout-seconds 120
ae-cli engage-flow report metric-detail export --project-id 1 --flow-id flow_id_123 --node-uuid node_uuid_123 --start-time 2026-04-01 --end-time 2026-04-07 --artifact-format csv --timeout-seconds 21600
ae-cli engage-flow metric-user run --project-id 1 --flow-id flow_id_123 --indicator-name entry --start-time 2026-04-01 --end-time 2026-04-07 --limit 100 --timeout-seconds 120
ae-cli engage-flow metric-user export --project-id 1 --flow-id flow_id_123 --indicator-name entry --start-time 2026-04-01 --end-time 2026-04-07 --artifact-format csv --timeout-seconds 21600
ae-cli engage-flow node-user run --project-id 1 --flow-id flow_id_123 --node-uuid node_uuid_123 --indicator-name entry --start-time 2026-04-01 --end-time 2026-04-07 --limit 100 --timeout-seconds 120
ae-cli engage-flow node-user export --project-id 1 --flow-id flow_id_123 --node-uuid node_uuid_123 --indicator-name entry --start-time 2026-04-01 --end-time 2026-04-07 --artifact-format csv --timeout-seconds 21600
ae-cli engage-flow node-metric-user run --project-id 1 --flow-id flow_id_123 --node-uuid node_uuid_123 --indicator-name metric_setting_id_123 --start-time 2026-04-01 --end-time 2026-04-07 --limit 100 --timeout-seconds 120
ae-cli engage-flow node-metric-user export --project-id 1 --flow-id flow_id_123 --node-uuid node_uuid_123 --indicator-name metric_setting_id_123 --start-time 2026-04-01 --end-time 2026-04-07 --artifact-format csv --timeout-seconds 21600

ユーザー詳細の run コマンドは、範囲が限定されたインライン行を対象とし、--request-id、--limit、--timeout-seconds を受け付けます。メトリック詳細の run はレポートオブジェクトを返します。エクスポートコマンドは --request-id、--artifact-format csv|jsonl（デフォルトは jsonl）、--timeout-seconds を受け付け、その後 run_id と artifact_id を返します。ae-cli engage-query run inspect --run-id RUN_ID で状態を確認し、続いて ae-cli engage-query artifact download --run-id RUN_ID --artifact-id ARTIFACT_ID --output ./artifact.jsonl.gz でダウンロードします。実行中の非同期処理をキャンセルするには、ae-cli engage-query query cancel --run-id RUN_ID を使用します。

フローレポート／ユーザー詳細コマンドでは、複雑な入力を作成する前に、対応するリファレンスをお読みください。

• フローキャンバスのカスタムメトリック設定：references/flow-metric-update.md
• メトリック詳細のレポートオブジェクトまたはフラット化されたレポートのエクスポート：references/flow-metric-detail-report.md
• プロセスレベルのメトリックセグメントに該当するユーザー：references/flow-metric-user.md
• ノードレベルのデータセグメントに該当するユーザー：references/flow-node-user.md
• ノードレベルのメトリックセグメントに該当するユーザー：references/flow-node-metric-user.md

5. シーン（シーン管理／設定センター）

新しい Capability ゲートウェイのコマンドグループ engage-scene では、設定センターを扱います。対象は設定項目、パラメーター、グループ、プリセット／関連メトリック、設定チャネル、戦略、テンプレートです。複雑な DTO は --payload（ネイティブのキャメルケースの JSON）で渡します。

# Config item list / get / create / update / delete
ae-cli engage-scene config-item list --project-id <project_id>
ae-cli engage-scene config-item get --project-id <project_id> --config-id <config_id>
ae-cli engage-scene config-item create --project-id <project_id> --config-id <config_id> --config-name <name> --business-type params
ae-cli engage-scene config-item update --project-id <project_id> --config-id <config_id> --config-name <name>
ae-cli engage-scene config-item delete --project-id <project_id> --config-id <config_id> --open-id <open_id> --yes

# Config param list / batch-add / update / batch-delete
ae-cli engage-scene config-param list --project-id <project_id> --config-id <config_id>
ae-cli engage-scene config-param batch-add --project-id <project_id> --config-id <config_id> --params '[{"param_name":"a","param_type":"string"}]'
ae-cli engage-scene config-param update --project-id <project_id> --config-id <config_id> --param-id <param_id> --param-name a
ae-cli engage-scene config-param batch-delete --project-id <project_id> --param-ids '[1,2]' --yes

# Config group list / batch-add / update / batch-delete
ae-cli engage-scene config-group list --project-id <project_id>
ae-cli engage-scene config-group batch-add --project-id <project_id> --group-names '["g1"]'
ae-cli engage-scene config-group update --project-id <project_id> --group-id <group_id> --group-name g2
ae-cli engage-scene config-group batch-delete --project-id <project_id> --group-ids '[1,2]' --yes

# Preset metric get / set
ae-cli engage-scene preset-metric get --project-id <project_id> --config-id <config_id>
ae-cli engage-scene preset-metric set --project-id <project_id> --config-id <config_id> --impression-event-definition '<semantic_event_json>'

# Config metric list / get / batch-add / update-rule / batch-delete
ae-cli engage-scene config-metric list --project-id <project_id> --config-id <config_id>
ae-cli engage-scene config-metric get --project-id <project_id> --metric-id <metric_id>
ae-cli engage-scene config-metric batch-add --project-id <project_id> --config-id <config_id> --ta-metric-ids '[1,2]'
ae-cli engage-scene config-metric update-rule --project-id <project_id> --metric-id <metric_id> --event-list '[{"event_name":"e1","filter":"true"}]'
ae-cli engage-scene config-metric batch-delete --project-id <project_id> --config-id <config_id> --metric-ids '[1,2]' --yes

# Config channel list / get / create / update / update-status / delete / query-log
# User params: reuse or discover verified customsParamList property names; then use user:<prop_name>
# Strategy custom audience: scene-strategy-audience.md — semantic definitionRequest; strategy predict for 预估人数
# Workflows: references/channel-mgmt.md · schema: references/scene-config-channel.md
ae-cli engage-scene config-channel list --project-id <project_id> [--channel-type 0|1]
ae-cli engage-scene config-channel get --project-id <project_id> --channel-id <channel_id>
ae-cli engage-scene config-channel create --project-id <project_id> --channel-name <name> --channel-type 0 --config '<json>'
ae-cli engage-scene config-channel update --project-id <project_id> --channel-id <channel_id> --channel-name <name> [--config '<json>']
ae-cli engage-scene config-channel update-status --project-id <project_id> --channel-id <channel_id> --channel-status 1|2
ae-cli engage-scene config-channel delete --project-id <project_id> --channel-id <channel_id> --yes
ae-cli engage-scene config-channel query-log --project-id <project_id> --channel-id <channel_id>

# Strategy create / update / log / batch-copy
ae-cli engage-scene strategy create --project-id <project_id> --payload '{"configId":"cfg-1","templateId":"tpl-1","strategyName":"s1"}'
ae-cli engage-scene strategy update --project-id <project_id> --payload '{"strategyUuid":"uuid-1"}'
ae-cli engage-scene strategy log --project-id <project_id> --strategy-uuid <uuid>
ae-cli engage-scene strategy predict --project-id <project_id> --definition-request '{"type":"condition","conditions":{...}}' --zone-offset 8 [--strategy-uuid <uuid>]
ae-cli engage-scene strategy batch-copy --project-id <project_id> --config-id <config_id> --strategy-ids '["s1"]'

# Template list / get / create / update / update-status / delete
ae-cli engage-scene template list --project-id <project_id> --config-id <config_id>
ae-cli engage-scene template get --project-id <project_id> --config-id <config_id> --template-id <template_id>
ae-cli engage-scene template create --project-id <project_id> --payload '{"configId":"cfg-1","templateId":"tpl-1","templateName":"t1"}'
ae-cli engage-scene template update --project-id <project_id> --payload '{"configId":"cfg-1","templateId":"tpl-1","config":[]}'
ae-cli engage-scene template update-status --project-id <project_id> --config-id <config_id> --template-id <template_id> --status 1
ae-cli engage-scene template delete --project-id <project_id> --config-id <config_id> --template-id <template_id> --yes

6. アクティビティ（キャンペーンアクティビティ）

新しい Capability ゲートウェイのコマンドグループ engage-activity では、キャンペーンアクティビティを扱います。対象はアクティビティ、承認ワークフロー、トピック、アクティビティタイプ、単独タスクです。複雑な DTO は --payload（ネイティブのキャメルケースの JSON）で渡します。

アクティビティペイロードの制約

アクティビティのトピックまたは単独タスクのペイロードを生成する前に、Hermes のアクティビティ UI で公開されているものと同じサブセットを必ず適用してください。

• triggerType は 0（スケジュール単発）または 1（スケジュール繰り返し）でなければなりません。アクティビティタスクでは、手動（2）またはトリガー型（3～6）のタスクタイプはサポートされていません。
• A/B テストまたは勝ち抜き実験を設定しないでください。expConfig を省略するか、{"enableExp":false} のみを使用し、実験以外の groupContentList グループを正確に 1 つ指定してください。
• 単独アクティビティタスクでは triggerTimeStrategy: "fixed_time_zone" と親アクティビティの tzOffset を使用してください。スケジュール時刻はアクティビティ期間内に収めてください。
• トピックのルートでサポートされるオーディエンスタイプは 1（カスタム）と 2（既存クラスター）であり、3（全ユーザー）はサポートされていません。単独アクティビティタスクでは 1、2、3 を使用できます。
• トピックタスクは、スケジュール、タイムゾーン、チャネル、頻度制限、チャネル接触制限、ホワイトリスト、実験設定をトピックから継承します。追加できるのは、対象を含める条件のみのカスタム definitionRequest です。タスクレベルの clusterKey、トリガールール、共有設定の上書きは生成しないでください。topic get が正規のタスクマーカー targetClusterType=1 を返した場合は、更新時にその値を維持してください。ただし、他のタスクレベルの値は使用しないでください。
• まず親アクティビティを特定し、編集可能（mappingStatus が 0、2、または 5）であることを確認してください。トピック、タスク、言語の上限はプロジェクト設定値です。既定値をハードコードしないでください。
• approval submit と approval approve は、保存済みのすべてのアクティビティタスクを検証します。承認によって、サポートされていないタスクデータが正規化されることはありません。ACTIVITY_TASK_COMPATIBILITY_VIOLATION が発生した場合は、必要に応じて承認を取り消すか申請を撤回し、報告された各タスクを修正または再作成してから、再度申請してください。

# Activity create / update / delete / list / get / pause / end / stats / info-list
ae-cli engage-activity activity create --project-id <project_id> --payload '{"activityName":"a1","activityType":"other_type","tzOffset":8,"periodType":0}'
ae-cli engage-activity activity update --project-id <project_id> --payload '{"activityId":"act-1","activityName":"a1","activityType":"other_type","tzOffset":8,"periodType":0}'
ae-cli engage-activity activity delete --project-id <project_id> --activity-id <activity_id> --yes
ae-cli engage-activity activity list --project-id <project_id> --page 1 --page-size 20
ae-cli engage-activity activity get --project-id <project_id> --activity-id <activity_id>
ae-cli engage-activity activity pause --project-id <project_id> --activity-id <activity_id>
ae-cli engage-activity activity end --project-id <project_id> --activity-id <activity_id>
ae-cli engage-activity activity stats --project-id <project_id>
ae-cli engage-activity activity info-list --project-id <project_id> --activity-id <activity_id>

# Approval submit / approve / reject / cancel
ae-cli engage-activity approval submit --project-id <project_id> --activity-id <activity_id> [--reason <reason>]
ae-cli engage-activity approval approve --project-id <project_id> --activity-id <activity_id>
ae-cli engage-activity approval reject --project-id <project_id> --activity-id <activity_id> --reason <reason>
ae-cli engage-activity approval cancel --project-id <project_id> --activity-id <activity_id>

# Topic create / update / remove-task / delete / get / copy
# See references/activity-topic.md for topicClusterKey vs task clusterKey and triggerType notes.
ae-cli engage-activity topic create --project-id <project_id> --payload '{"activityId":"act-1","topicName":"t1","targetClusterType":2,"topicClusterKey":"<cluster>","channelType":1,"channelId":"c1","triggerType":0,"triggerTime":"2026-12-31 12:00","enableChannelTouchLimits":false,"frequencyLimits":"{}","tasks":[...]}'
ae-cli engage-activity topic update --project-id <project_id> --payload '{"topicId":"topic-1", ...}'
ae-cli engage-activity topic remove-task --project-id <project_id> --task-id <task_id> --yes
ae-cli engage-activity topic delete --project-id <project_id> --topic-id <topic_id> --yes
ae-cli engage-activity topic get --project-id <project_id> --topic-id <topic_id>
ae-cli engage-activity topic copy --project-id <project_id> --topic-id <topic_id> [--new-name <name>]

# Activity type list / batch-add / update / batch-delete
ae-cli engage-activity activity-type list --project-id <project_id>
ae-cli engage-activity activity-type batch-add --project-id <project_id> --type-names '["t1","t2"]'
ae-cli engage-activity activity-type update --project-id <project_id> --id <type_id> --type-name t3
ae-cli engage-activity activity-type batch-delete --project-id <project_id> --ids '["id1","id2"]' --yes

# Standalone task get / create / update / copy
ae-cli engage-activity task get --project-id <project_id> --task-id <task_id>
ae-cli engage-activity task create --project-id <project_id> --payload '{"taskName":"t1","activityId":"act-1", ...}'
ae-cli engage-activity task update --project-id <project_id> --payload '{"taskId":"task-1", ...}'
ae-cli engage-activity task copy --project-id <project_id> --task-id <task_id> [--new-name <name>]

7. workbench

新しい capability-gateway コマンドグループ engage-workbench は、ワークベンチのメトリックスロットに対応します。各ユーザーはプロジェクトごとに最大 4 枚のメトリックカードを設定できます。スロットはユーザーごとに設定され、update／delete で変更できるのは呼び出し元自身のスロットのみです。最初の list で 4 つの既定スロットが自動的に初期化されます。

# Workbench slot list / add / update / delete
ae-cli engage-workbench workbench list --project-id <project_id>
ae-cli engage-workbench workbench add --project-id <project_id> --metric-type <metric_type> --date-type <date_type> --order-id 1
ae-cli engage-workbench workbench update --project-id <project_id> --slot-id <slot_id> --metric-type <metric_type> --date-type <date_type> --order-id 1
ae-cli engage-workbench workbench delete --project-id <project_id> --slot-id <slot_id> --yes

engage-flow flow save の重要な制約

ユーザーが「フローを作成する／フローキャンバスを生成する／フローを保存する」ことを希望する場合、engage-flow flow save を通常の単一コマンドとして扱わないでください。以下のワークフローに従う必要があります。

必須ワークフロー

1. まず、ユーザーの意図が十分に具体的かどうかを確認します。最低限、次の情報が必要です。

   • ビジネスシナリオ
   • 対象ユーザー
   • タッチポイントまたは提供方法
   • 分岐が必要かどうか、および分岐条件

2. 自然言語から直接 --req に進んではいけません。まず、安定した中間的な意図の構造を整理し、それを最終的な req にマッピングする必要があります。

3. 条件関連ノードは、意味的な targetDefinitionRequest オブジェクトと triggerDefinition オブジェクトを使って構築します。実際のイベント名とプロパティ名は Analysis メタデータを通じて解決してください。 永続化された QP を取得するためだけに中間クラスターを作成してはいけません。

4. message_push、wechat_push、webhook_push などのタッチポイントノードを構築する前に、次を呼び出す必要があります。

ae-cli engage-setting channel list --project-id <projectId>

5. engage-flow flow save は操作ベース（プロトコル v2）です。--req オブジェクトには、build、preview、commit のいずれかの operation を指定する必要があります。古い nodeList / edgeList フィールド名は使用せず、operation=build を指定して nodes / edges を使用してください。従来の nodeList / edgeList ペイロード（または operation の欠落）は、Unsupported save_flow operation: null というエラーで拒否されます。
6. 次のライフサイクルを実行します。build（data.result.status = ready_to_preview または need_input を返す）→ data.result.next_slot を解決 → preview（応答フィールド data.result.draft_version + data.result.confirm_token を再発行）→ commit（これらの値をリクエストフィールド draftVersion + confirmToken にマッピング）→ data.result.result.flow_uuid から最終 ID を読み取ります。
7. nodes[].config / edges[].config は、JSON オブジェクトまたは JSON 文字列にできます。カスタムオーディエンスノードと分岐には、意味的な targetDefinitionRequest を使用します。Hermes がこれをノードに保存される実行形式にコンパイルします。 targetClusterQp は決して送信しないでください。各オーディエンスの event と behavior_sequence には、それぞれ固有の time_range を含める必要があります。Flow の開始日は、その範囲の代わりにはなりません。現在のプロジェクト、タイムゾーン、ユーザーエンティティのメタデータスコープを通じて解決されるプロパティのみを使用してください。
8. プレビューまたはコミットの前に、次の点を必ず自己チェックしてください。
   • 開始ノードがちょうど 1 つである
   • exit_flow が少なくとも 1 つある
   • edge.source と edge.target がどちらも有効なノードを参照している
   • 分岐ノードの sourceBranchId が、上流ノードの config ですでに宣言されている
   • グラフ全体が DAG であり、循環がない

明示的に禁止されていること

• channelId を創作しないでください
• ユーザーから十分な情報が提供されていない場合に、分岐ロジックを補完しないでください
• ビジネス上の意味を持つノードを、最終的な nodes として直接送信しないでください
• 従来の nodeList / edgeList を使用せず、operation を省略しないでください

推奨される順序

User request
-> Organize intent
-> analysis user-cluster create/get
-> engage-setting channel list --project-id <projectId>
-> Build nodes / edges
-> Self-check
-> engage-flow flow save operation=build -> (need_input?) -> preview -> commit
-> engage-flow flow get (verify)

詳細な生成ルールについては、まず次の資料を参照してください。

• references/save-flow.md
• references/flow-node-config-schema.md
• references/validate-flow-node-config.md

ドライランのデバッグ

ae-cli --dry-run engage-setting channel list --project-id 1
ae-cli --dry-run engage-task task list --project-id 1 --req '{"pageNum":1,"pageSize":20}'
ae-cli --dry-run engage-task task build-save-guide --project-id 1 --req '{}'
ae-cli --dry-run engage-task task save --project-id 1 --req '{"baseInfo":{"taskName":"Demo Task"},"channelConfig":{"channelType":1,"channelId":"channel_123","groupContentList":[{"contentList":[{"pushLanguageCode":"default","content":"[]"}]}]},"targetConfig":{"targetClusterType":3},"triggerConfig":{"triggerType":2},"controlConfig":{"completionIndicatorDef":{"completionIndicators":[]}}}'
ae-cli --dry-run engage-flow flow list --project-id 1

参考資料

ビジネス指向の references/ ディレクトリには、単一コマンドのより詳細なガイダンスがあります。

• references/channel-list.md (engage-setting.channel.list)
• references/channel-detail.md (engage-setting.channel.get)
• references/add-channel.md (engage-setting.channel.create)
• references/update-channel-status.md (engage-setting.channel.update-status)
• references/delete-channel.md (engage-setting.channel.delete)
• references/channel_touch_limits_list.md (engage-setting.channel-touch-limits.list)
• references/channel-touch-limits-batch-update.md (engage-setting.channel-touch-limits.batch-update)
• references/channel-touch-limits-toggle.md (engage-setting.channel-touch-limits.toggle)
• references/channel-touch-limits-save.md (engage-setting.channel-touch-limits.save)
• references/channel-update-config.md (engage-setting.channel.update-config)
• references/channel-test-send.md (engage-setting.channel.test-send)
• references/approval-approver-delete.md (engage-setting.approval-approver.delete)
• references/add-approver.md / references/approver-list.md (engage-setting.approval-approver.{add,list})
• references/whitelist-list.md / references/whitelist.md (engage-setting.whitelist.{list,add,update,delete,verify})
• references/cancel-query-by-request-id.md (engage-setting.query.cancel, L3)
• references/cancel-query-run.md (engage-query.query.cancel)
• references/push-language.md (engage-setting.push-language.{get,set})
• references/client-param.md (engage-setting.client-param.{create,update,delete,list})
• references/config-table.md (engage-setting.config-table.{upload,save,list,query-data,update-data,delete})
• references/preset-event.md (engage-setting.preset-event.{list,update})
• references/common-metric.md (engage-setting.common-metric.{list,get,create,update,delete})
• references/scene-config-item.md (engage-scene.config-item.{list,get,create,update,delete})
• references/scene-config-param.md (engage-scene.config-param.{list,batch-add,update,batch-delete})
• references/scene-config-group.md (engage-scene.config-group.{list,batch-add,update,batch-delete})
• references/scene-preset-metric.md (engage-scene.preset-metric.{get,set})
• references/scene-config-metric.md (engage-scene.config-metric.{list,get,batch-add,update-rule,batch-delete})
• references/scene-config-channel.md (engage-scene.config-channel.{list,get,create,update,update-status,delete,query-log})
• references/channel-mgmt.md（チャンネル設定の管理ワークフロー）
• references/scene-strategy.md (engage-scene.strategy.{list,get,create,update,log,predict,batch-copy,manage})
• references/scene-strategy-audience.md（カスタムオーディエンスのセマンティクス definitionRequest、事前チェック、予測）
• references/scene-template.md (engage-scene.template.{list,get,copy,create,update,update-status,delete})
• references/config-item-trigger-report.md (engage-scene.report.config-item-trigger, L3)
• references/config-item-analysis-report.md (engage-scene.report.config-item-analysis, L3)
• references/config-item-strategy-comparison.md (engage-scene.report.strategy-comparison, L3)
• references/activity-activity.md (engage-activity.activity.{create,update,delete,list,get,pause,end,stats,info-list})
• references/activity-data-detail.md (engage-activity.activity-data.detail, L3)
• references/activity-approval.md (engage-activity.approval.{submit,approve,reject,cancel})
• references/activity-topic.md (engage-activity.topic.{create,update,remove-task,delete,get,copy})
• references/activity-activity-type.md (engage-activity.activity-type.{list,batch-add,update,batch-delete})
• references/activity-task.md (engage-activity.task.{get,create,update,copy})
• references/workbench-workbench.md (engage-workbench.workbench.{list,add,update,delete})
• references/build-task-save-guide.md
• references/save-task.md
• references/task-list.md
• references/flow-list.md
• references/operation-log-query.md (engage-flow.operation-log.query)
• references/task-operation-log-query.md (engage-task.operation-log.query)
• references/version-list.md (engage-flow.version.list)
• references/flow-update-remark.md (ae-cli engage-flow flow update-remark；機能 engage-flow.version.update-remark)
• references/push-record-query.md (engage-task.push-record.query)
• references/task-user-detail-export.md (engage-task user-detail export；機能 engage-task.user-detail.export)
• references/task-indicator-user.md (engage-task indicator-user {sql,run,export}；機能 engage-task.indicator-user.{sql,run,export})
• references/segment-list-query.md (engage-task.segment-list.query)
• references/group-list.md (engage-task.group.list)
• references/task-delete.md (engage-task.task.delete)
• references/task-submit-approval.md (engage-task.task.submit-approval)
• references/task-data-detail.md (engage-task data-detail query；機能 engage-task.task-data.detail)
• references/task-metric-detail.md (engage-task effect query；機能 engage-task.task-data.metric-detail)
• references/task-metric-update.md (engage-task metric update；機能 engage-task.metric.update)
• references/flow-metric-update.md (engage-flow metric update；機能 engage-flow.metric.update) このドキュメント構成では、より複雑なオブジェクト入力を必要とするコマンドを references/ ルートディレクトリに集約できるため、後から拡張しやすくなります。

コマンドグループ

setting

channel-touch-limits list / channel-touch-limits batch-update / channel-touch-limits toggle / channel-touch-limits save / channel update-config / channel test-send / channel list / channel get / channel create / channel update-status / channel delete / approval-approver add / approval-approver list / approval-approver delete / whitelist list / whitelist add / whitelist update / whitelist delete / whitelist verify / push-language get / push-language set / client-param create / client-param update / client-param delete / client-param list / config-table upload / config-table save / config-table list / config-table query-data / config-table update-data / config-table delete / preset-event list / preset-event update / common-metric list / common-metric get / common-metric create / common-metric update / common-metric delete（engage-setting 経由）、および L3 機能 engage-setting.query.cancel

task

operation-log query / push-record query / user-detail export / indicator-user sql / indicator-user run / indicator-user export / segment-list * / ops * / metric * / race release / channel-ref stats / group * / task delete / task modify-group / task submit-approval / task get / task list / task stats / task build-save-guide / task save / task manage / effect query / data-detail query（engage-task 経由）、および L3 機能 engage-task.task-data.{overview,detail,metric-detail,experiment-report}

query

run inspect / artifact download / query cancel（engage-query 経由）、機能 ID engage-query.query.cancel

config

従来の config MCP コマンドは、scene L2 グループと以下の 3 つの L3 レポート機能に移行されます。

scene

config-item list / config-item get / config-item create / config-item update / config-item delete / config-param list / config-param batch-add / config-param update / config-param batch-delete / config-group list / config-group batch-add / config-group update / config-group batch-delete / preset-metric get / preset-metric set / config-metric list / config-metric get / config-metric batch-add / config-metric update-rule / config-metric batch-delete / config-channel list / config-channel get / config-channel create / config-channel update / config-channel update-status / config-channel delete / config-channel query-log / strategy list / strategy get / strategy create / strategy update / strategy log / strategy batch-copy / strategy manage / template list / template get / template copy / template create / template update / template update-status / template delete（engage-scene 経由）、機能 ID engage-scene.config-item.{list,get,create,update,delete}、engage-scene.config-param.{list,batch-add,update,batch-delete}、engage-scene.config-group.{list,batch-add,update,batch-delete}、engage-scene.preset-metric.{get,set}、engage-scene.config-metric.{list,get,batch-add,update-rule,batch-delete}、engage-scene.config-channel.{list,get,create,update,update-status,delete,query-log}、engage-scene.strategy.{list,get,create,update,log,batch-copy,manage}、engage-scene.template.{list,get,copy,create,update,update-status,delete}、および L3 機能 engage-scene.report.{config-item-trigger,config-item-analysis,strategy-comparison}

アクティビティ

activity create / activity update / activity delete / activity list / activity get / activity pause / activity end / activity stats / activity info-list / approval submit / approval approve / approval reject / approval cancel / topic create / topic update / topic remove-task / topic delete / topic get / topic copy / activity-type list / activity-type batch-add / activity-type update / activity-type batch-delete / task get / task create / task update / task copy（engage-activity 経由）、ケイパビリティ ID engage-activity.activity.{create,update,delete,list,get,pause,end,stats,info-list}、engage-activity.approval.{submit,approve,reject,cancel}、engage-activity.topic.{create,update,remove-task,delete,get,copy}、engage-activity.activity-type.{list,batch-add,update,batch-delete}、engage-activity.task.{get,create,update,copy}

ワークベンチ

workbench list / workbench add / workbench update / workbench delete（engage-workbench 経由）、ケイパビリティ ID engage-workbench.workbench.{list,add,update,delete}

フロー

operation-log query / version list / flow update-remark / flow save / node-config schema / flow get / flow list / flow manage / node-config validate / flow delete / flow modify-base-info / metric update / report metric-detail run / report metric-detail export / metric-user run / metric-user export / node-user run / node-user export / node-metric-user run / node-metric-user export（engage-flow 経由）、および L3 ケイパビリティ engage-flow.report.{node-overview,process,node-detail,ab-split-node}

日付形式

日付パラメーターを受け取るコマンドでは、通常 yyyy-MM-dd 形式を使用します。例：--start_time 2026-04-01。

書き込み操作に関する注意

すべての書き込み操作には、対応するユーザーの意図が必要です。リスクの高い削除コマンド（risk: high-risk-write）を実行する場合は、さらに明示的な確認が必要です。通常の書き込み操作（risk: write）では、追加の確認は不要です。

• チャネル：engage-setting channel create（書き込み）、engage-setting channel delete（リスクの高い書き込み）、engage-setting channel update-status（書き込み）
• 設定チャネル（設定センターのチャネル管理）：engage-scene config-channel create|update|update-status（書き込み）、engage-scene config-channel delete（リスクの高い書き込み）
• 戦略と設定項目：engage-scene config-item delete（リスクの高い書き込み）、engage-scene template copy と engage-scene strategy manage（書き込み）
• フロー：engage-flow flow update-remark（書き込み）、engage-flow flow save（書き込み）、engage-flow flow modify-base-info（書き込み）、engage-flow flow manage（書き込み）、engage-flow flow delete（リスクの高い書き込み）
• タスク：engage-task task save（書き込み）、engage-task task submit-approval（書き込み）、engage-task task manage（書き込み）

タスクの下書きを作成または更新する場合は、次のワークフローを使用してください。

1. ae-cli engage-setting channel list --project-id <projectId>
2. ae-cli engage-task task build-save-guide --project-id <projectId> --req '{...}'
3. カスタムオーディエンスの場合は、Analysis のセマンティックコントラクトを targetConfig.definitionRequest として渡します。イベントトリガー型タスクの場合は、セマンティックな triggerConfig.triggerDefinition を使用し、メインの A ルールには必ず periodTimeSymbol（TS01、TS02、TS03、または TS04）を含めてください。セマンティックな completionIndicatorDef.completionIndicators[].eventDefinition を使用します。 ae-analysis のユーザークラスターモデル／オーディエンスモデルから構造を構築します。既存クラスターのオーディエンス （targetClusterType=2）には、analysis user-cluster get を使用します。イベントトリガー型タスクでは、 channelType、triggerType、eventTriggerType を build-save-guide に渡し、その後、タイプ固有のセマンティックなイベント構造を使用します。累積イベントは集計条件、継続イベントは値が 2 以上の count/eq、順序付きイベントはシーケンスステップのエンベロープ、毎回完了イベントは count/eq/1 を使用します。完了ターゲットと実験の主目標イベントフィルターでは、メタデータの select_type が datetime のプロパティを使用してはいけません。永続化される QP フィールドは構築しないでください。 配信側に応じてオーディエンスを選択します。サーバー側チャネルではカスタム（1）または既存（2）を使用でき、全ユーザー（3）は指定できません。client_push（channelType=3）ではカスタム（1）または全ユーザー（3）を使用でき、既存（2）は指定できません。triggerType だけからオーディエンスの対応可否を推測しないでください。
4. ae-cli engage-task task save --project-id <projectId> --req '{...}'

下書きのみのリクエストでは、下書きを保存して検証した後に停止してください。承認の申請は、それがユーザーの意図に明示的に含まれる場合に限って行います。 ae-cli engage-task task submit-approval --project-id <projectId> --task-id <taskId>.

engage-task task build-save-guide は読み取り専用のヘルパーです。シナリオ固有の必須フィールド、チャネルのコンテンツスキーマ、非対応の組み合わせ、例、および save_task 用の引き継ぎテンプレートを返します。 enableExp=true の場合、機能 engage-task.task.build-save-guide は引き継ぎ内容を拡充し、 groupContentList の関連付けフィールド （expGroupName／expGroupType／percentageInExperiment／order）が expConfig.expGroupList と一致した状態を保てるようにします。変更するのは contentList[].content のみです。機能 engage-task.task.save は、実験コンテンツの不整合を TASK_EXPERIMENT_GROUP_CONTENT_INVALID で拒否します。

engage-task task save はタスク設定を作成または更新します。承認の申請、配信の開始、タスク実行のトリガーは行いません。req.taskId が省略された場合は新しい下書きを作成し、req.taskId が指定された場合は既存の下書きまたは一時停止中のタスクを更新します。更新モードでは、実行中／終了済みのタスクは invalid_status で拒否されます。検証前に、省略されたフィールドは既存のタスクの値を引き継ぎます（部分的な名前変更／更新がサポートされています）。

承認の申請が求められている場合は、task save の後に engage-task task submit-approval --task-id を使用する方法を推奨します。 この方法では、エージェントが内部の trigger_rule を再構築することなく、保存済みの下書きを申請できます。 従来の --request モードも互換性のために引き続き利用できます。--task-id または --request のいずれか一方だけを指定してください。

オーディエンスの作成は固定の事前確認手順ではありません。カスタムタスクオーディエンスには、セマンティックな targetConfig.definitionRequest を使用します。task get は同じコントラクトを definition_request として返します。clientConfig.clientQp はサーバーが生成するため、Capability リクエストから省略してください。部分更新では既存のサーバー状態が保持されます。生の QP を手動で組み立てないでください。 behavior_sequence では、2 番目のステップの relative_to_first を省略するか、false に設定してください。true を使用するのは、ウィンドウをステップ 1 から測定するステップ 3 以降に限ります。