claude-skills/

Anthropic公式スキル・プラグインの日本語ディレクトリ

last sync 22h ago
スキルOfficialdevelopment

📊aidp-observability

プラグイン
oracle-ai-data-platform-workbench-engineer-agent
ソース
GitHub で見る ↗

説明

AIDP の運用状態を表示します — 最近アクセスしたリソースや、長時間実行中の非同期オペレーション（ステータス、完了状況、待機中）を確認できます。 次のような場合に使用: ユーザーが「最近何があったか」「何が実行中か」「あのオペレーションはもう完了したか」と尋ねたとき、または非同期の AIDP オペレーション（プロビジョニング、大規模コミットなど）を追跡・待機する必要があるとき。 公式の `aidp` CLI を介して動作します。

原文を表示

Surface AIDP operational state — recently accessed resources and long-running async operations (status, completion, waiting). Use when the user asks "what happened recently", "what's running", "is that operation done yet", or needs to track/await an async AIDP operation (e.g. provisioning, large commits). Runs over the official `aidp` CLI.

ユースケース

  • ✓最近アクセスしたリソースを確認する
  • ✓実行中のオペレーション状況を確認する
  • ✓非同期操作の完了状況を追跡する
  • ✓長時間実行中の処理を待機する

本文（日本語訳）

aidp-observability — アクティビティ & 非同期オペレーション

AIDPワークスペース内の状況を可視化します: 直近のジョブ実行履歴と、長時間実行中のオペレーションの状態を確認できます。

主エンジン: Oracle公式 aidp CLI（async-operations + workflow list-recent-job-runs）
CLIがインストールされていない場合のフォールバックとして oci raw-request を使用します。
読み取り専用 — ペイロードの永続化は不要です。

次のような場合に使用

  • 「最近何を操作したか / 現在何が動いているか確認したい」
  • 「オペレーション X は完了したか？」
  • プロビジョニングや長時間のコミット処理の完了を待機したい

CLI（推奨）

references/aidp-cli-map.md に従い、async-operations list | get および workflow list-recent-job-runs を使用します。
いずれも --instance-id <DATALAKE_OCID> --auth api_key --profile DEFAULT --region <r> が必要です （ワークスペーススコープ — 対象ワークスペースを確認してください）。

# 実行中のオペレーション — resource-type / フィルタパラメータが必須
aidp async-operations list --resource-type <type> \
  --instance-id <DATALAKE_OCID> --auth api_key --profile DEFAULT --region us-ashburn-1

# 特定オペレーションの状態確認
aidp async-operations get <key> --instance-id <DATALAKE_OCID> --auth api_key --profile DEFAULT --region us-ashburn-1

# 直近のジョブ実行履歴
aidp workflow list-recent-job-runs --instance-id <DATALAKE_OCID> --auth api_key --profile DEFAULT --region us-ashburn-1

フォールバック（CLIなし） — oci raw-request を使用して …/20240831/dataLakes/<DATALAKE_OCID>/… に対して同等のREST + 認証を実行します （認証手順は references/oci-raw-request.md を参照）:

oci raw-request --http-method GET \
  --target-uri "https://aidp.us-ashburn-1.oci.oraclecloud.com/20240831/dataLakes/<OCID>/asyncOperations?<param>=<value>" \
  --profile DEFAULT

  • GET …/asyncOperations?<param>=<value>
    クエリパラメータは必須です。パスのみでリクエストすると 400 InvalidParameter: query param X must not be null が返されます。
    エラーメッセージに不足しているパラメータ名（例: resource-type / workspaceKey / status）が示されます。
    sortBy=timeCreated も指定可能です。

  • GET …/asyncOperations/<key> — 特定オペレーションの取得

  • GET …/recentActivities はテスト時（2026-06-10）に404を返しました —
    「直近のアクティビティ」確認にはCLIの workflow list-recent-job-runs を優先してください。
    実際の読み取りでプロビジョニング済みと確認できない限り、recentActivities は利用不可として扱ってください。

2026-06-10 de-agentにて実機検証済み — 補足情報:
必須フィルタは具体的に status= または resourceType= のいずれかです。
GET …/asyncOperations をそのまま叩くと 400 MissingParameter: "ResourceType or Status filter need to be specified" が返されます。

200レスポンスが確認されたパターン:

  • ?status=SUCCEEDED（実際の CREATE_CLUSTER/CREATE_WORKSPACE レコードが返却）
  • ?resourceType=CLUSTER
  • 個別取得 …/asyncOperations/<key>

…/recentActivities は 404 NotAuthorizedOrNotFound を返しました（当環境では未プロビジョニング）。
代わりに ?status= / ?resourceType= または aidp workflow list-recent-job-runs を使用してください。

ワークフロー

  • 実行中のオペレーション確認:
    aidp async-operations list --resource-type <type> → キー・タイプ・状態・開始時刻のテーブルを表示

  • 特定オペレーションの状態確認:
    aidp async-operations get <key> → オペレーションの現在の state を報告

  • 完了まで待機（ポーリング）:
    aidp async-operations get <key> を一定間隔でポーリング（バックオフあり、合計待機時間に上限を設ける）し、 終端状態になったら報告します。
    プロビジョニング（aidp-workspace-admin）、バンドルデプロイ（aidp-bundle）、 またはその他の 202 非同期アクションの後に使用してください。
    これらのアクションはオペレーションキーを datalake-async-operation-key ヘッダまたはボディフィールドで返します （リファレンスの「Asyncノート」を参照）。

  • 直近のアクティビティ確認:
    aidp workflow list-recent-job-runs → リソース・アクション・時刻を表示

注意事項

  • ワークスペーススコープ — 対象ワークスペースを必ず確認してください。
  • async-operations list には resource-type / フィルタパラメータ が必要です （ライブマップでのシェイプはTBD）。
    まず実行して400エラーを読み取り、指定されたパラメータを補完してください。
    実際に2xxが記録されるまで確認済みとして提示しないでください（no-fabricationゲート）。
  • SparkジョブやステージのログやClusterログの診断には aidp-spark-debugging を使用してください。
    本スキルはプラットフォームレベルのオペレーション追跡であり、Spark内部の解析は対象外です。

参考リファレンス

原文（English）を表示

aidp-observability — activity & async operations

Show what's happening in the AIDP workspace: recent job runs and the state of long-running operations. Primary engine: the official Oracle aidp CLI (async-operations + workflow list-recent-job-runs); oci raw-request is the fallback when the CLI isn't installed. Read-only — no payload persistence needed.

When to use

  • "What did I touch recently / what's running?" · "is operation X done?" · waiting on a provisioning or long commit to finish.

CLI (preferred)

Per references/aidp-cli-map.md: async-operations list | get and workflow list-recent-job-runs. All take --instance-id <DATALAKE_OCID> --auth api_key --profile DEFAULT --region <r> (workspace-scoped — confirm the workspace).

# In-flight ops — a resource-type / filter param is REQUIRED
aidp async-operations list --resource-type <type> \
  --instance-id <DATALAKE_OCID> --auth api_key --profile DEFAULT --region us-ashburn-1
aidp async-operations get <key> --instance-id <DATALAKE_OCID> --auth api_key --profile DEFAULT --region us-ashburn-1   # status of one
# Recent job runs
aidp workflow list-recent-job-runs --instance-id <DATALAKE_OCID> --auth api_key --profile DEFAULT --region us-ashburn-1

Fallback (no CLI) — same REST + auth via oci raw-request against …/20240831/dataLakes/<DATALAKE_OCID>/… (auth ladder in references/oci-raw-request.md):

oci raw-request --http-method GET \
  --target-uri "https://aidp.us-ashburn-1.oci.oraclecloud.com/20240831/dataLakes/<OCID>/asyncOperations?<param>=<value>" \
  --profile DEFAULT

GET …/asyncOperations?<param>=<value> (a query param is required — a bare path returns 400 InvalidParameter: query param X must not be null; the error names the missing param, e.g. a resource-type / workspaceKey / status; also accepts sortBy=timeCreated) · GET …/asyncOperations/<key> for one. GET …/recentActivities returned 404 in testing (2026-06-10) — prefer the CLI workflow list-recent-job-runs for "recent activity"; treat recentActivities as not provisioned unless a live read says otherwise.

Live-verified 2026-06-10 on de-agent — correction: the required filter is specifically status= or resourceType=. A bare GET …/asyncOperations returns 400 MissingParameter: "ResourceType or Status filter need to be specified". Confirmed 200s: ?status=SUCCEEDED (returned real CREATE_CLUSTER/CREATE_WORKSPACE records), ?resourceType=CLUSTER, and get-one …/asyncOperations/<key>. …/recentActivities returned 404 NotAuthorizedOrNotFound (not provisioned here) — use ?status=/?resourceType= or aidp workflow list-recent-job-runs instead.

Workflow

  • In-flight ops: aidp async-operations list --resource-type <type> → table of key, type, state, started.
  • Status of one: aidp async-operations get <key> → report the operation's current state.
  • Block until done: poll aidp async-operations get <key> on an interval (back off; clamp total wait) until a terminal state, then report it. Use this after provisioning (aidp-workspace-admin), bundle deploys (aidp-bundle), or other 202-async actions — those return an operation key in the datalake-async-operation-key header or a body field (see the Async note in the reference).
  • Recent activity: aidp workflow list-recent-job-runs → present resource, action, time.

Notes

  • Workspace-scoped — confirm the workspace.
  • async-operations list needs a resource-type / filter param (shape-TBD in the live map) — probe, read the 400, supply the named param. Don't present it as confirmed until a live 2xx is recorded (no-fabrication gate).
  • For Spark job/stage/cluster-log diagnostics use aidp-spark-debugging; this skill is platform-level operation tracking, not Spark internals.

References

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。