AIDP ユーザー設定の管理 — DataLakeのユーザー設定の一覧表示、取得、作成、更新、削除を行います。ユーザーが AIDP ワークベンチ(データ分析作業環境)の設定を表示または変更したい場合、または保存済みのユーザー設定を管理したい場合に使用します。 独立した機能であり、公式コマンド `aidp user-setting` CLI の使用が推奨されます。それが利用できない場合は、`oci raw-request` をフォールバック(代替手段)として使用できます。
Manage AIDP user settings / preferences — list, get, create, update, delete a user's settings for the DataLake. Use when the user wants to view or change their AIDP workbench preferences/settings, or manage stored user-setting entries. Self-contained — official `aidp user-setting` CLI preferred, `oci raw-request` fallback.
aidp-user-settings — ユーザー設定 & プリファレンスAIDPユーザー設定エントリの読み取りおよび管理を行います。
自己完結型のスキルであり、MCP や ai-data-engineer-agent は不要です。
エンジンの優先順位は references/aidp-cli-map.md に従い、公式の aidp CLI を優先し、使用できない場合は oci raw-request を使用します。
aidp user-setting list <instance-id> --auth api_key --profile DEFAULTaidp user-setting get|create|update|delete <instance-id> …
(各コマンドのキーやリクエストボディは aidp help user-setting を参照。create/update には --body で JSON を指定)oci raw-request):
…/20240831/dataLakes/<OCID>/userSettings — 実環境で200確認済み(レークスコープ、2026-06-10)
CRUD操作: GET …/userSettings/{key}、POST / PUT / DELETE
(create/updateのリクエストボディは、書き込み前に aidp help user-setting または実際のデータ読み取りで確認すること)CreateUserSettingDetailsCLI: aidp user-setting create <DATALAKE_OCID> --body <JSON>(CLI README「user-setting create」参照)
エンベロープ(SDK create_user_setting_details.py:34-44):
| フィールド(ワイヤー名) | 必須 | 備考 |
|---|---|---|
name |
✅ | ユーザーフレンドリーな設定名 |
isDefault |
✅ | そのタイプのデフォルト設定として指定するフラグ |
data |
✅ | ネストされた SettingData。識別子 type は IAM_USER_CREDENTIAL | GIT_ACCOUNT | OAUTH のいずれか(setting_data.py:18-26) |
data のバリアント(サブクラスモデル + CLI README「user-setting create」):
type |
フィールド(ワイヤー名) | 参照元 |
|---|---|---|
GIT_ACCOUNT |
entityType(PERSONAL_ACCESS_TOKEN)、providerName(GITHUB | BITBUCKET | GITLAB | OCI_DEVOPS)、username、personalAccessToken |
git_account_user_setting.py:77-83、列挙型 …:18-34 |
IAM_USER_CREDENTIAL |
userId、tenancy、region、fingerprint、privateApiKey |
iam_user_credential_user_setting.py:57-64 |
GIT_ACCOUNT の例 —
.aidp/payloads/create-<name>-user-setting.json に保存してから内容を確認すること。
personalAccessToken / privateApiKey は秘密情報であり、ボディ内で渡すのみとし、絶対に出力・返却しないこと:
{
"name": "my_github",
"isDefault": true,
"data": {
"type": "GIT_ACCOUNT",
"entityType": "PERSONAL_ACCESS_TOKEN",
"providerName": "GITHUB",
"username": "<user>",
"personalAccessToken": "<PAT>"
}
}
フィールド名は確認済みです(SDK
attribute_map+ CLI README)。…/userSettingsの GET は実環境で200確認済み(レークスコープ、2026-06-10)。 create後はデータを再読み取りしてラウンドトリップを確認してください。
list / get で現在の設定を確認する。aidp-user-settings — user settings & preferencesRead and manage AIDP user-setting entries. Self-contained: no MCP / ai-data-engineer-agent required.
Engine precedence per references/aidp-cli-map.md — prefer the official aidp CLI, else oci raw-request.
aidp user-setting list <instance-id> --auth api_key --profile DEFAULTaidp user-setting get|create|update|delete <instance-id> … (see aidp help user-setting for the
key/body of each; create/update take a --body JSON).oci raw-request): …/20240831/dataLakes/<OCID>/userSettings — live-verified 200
(lake-scoped, 2026-06-10); GET …/userSettings/{key}, POST/PUT/DELETE for CRUD (confirm the
create/update body via aidp help user-setting / a live read before writing).CreateUserSettingDetailsCLI: aidp user-setting create <DATALAKE_OCID> --body <JSON> (CLI README "user-setting create").
Envelope (SDK create_user_setting_details.py:34-44):
| Field (wire) | Req | Notes |
|---|---|---|
name |
✅ | user-friendly setting name |
isDefault |
✅ | mark this the default for its type |
data |
✅ | nested SettingData; discriminator type ∈ IAM_USER_CREDENTIAL | GIT_ACCOUNT | OAUTH (setting_data.py:18-26) |
data variants (subclass models + CLI README "user-setting create"):
type |
Fields (wire) | Source |
|---|---|---|
GIT_ACCOUNT |
entityType (PERSONAL_ACCESS_TOKEN), providerName (GITHUB|BITBUCKET|GITLAB|OCI_DEVOPS), username, personalAccessToken |
git_account_user_setting.py:77-83, enums …:18-34 |
IAM_USER_CREDENTIAL |
userId, tenancy, region, fingerprint, privateApiKey |
iam_user_credential_user_setting.py:57-64 |
Example (GIT_ACCOUNT) — persist to .aidp/payloads/create-<name>-user-setting.json and confirm first;
personalAccessToken/privateApiKey are secret material — pass in the body, never echo back:
{
"name": "my_github",
"isDefault": true,
"data": {
"type": "GIT_ACCOUNT",
"entityType": "PERSONAL_ACCESS_TOKEN",
"providerName": "GITHUB",
"username": "<user>",
"personalAccessToken": "<PAT>"
}
}
Field names are confirmed (SDK
attribute_map+ CLI README).…/userSettingsGET is live-200 (lake-scoped, 2026-06-10); still re-read after create to confirm the round-trip.
list/get to show current settings.原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。