Adobe CX Coworker GatewayのAdobe Experience Platformツール aep-mcp
Adobe Experience Platform製品ツールを使用して、MCP対応クライアントからスキーマ、データセット、データガバナンス設定、クエリサービスリソース、監査イベントを調べることができます。 これらのツールは、組織が有効になっていて、ユーザーアカウントに必要なExperience Platform権限が付与されている場合、Adobe CX Coworker Gatewayから利用できます。
概要
search_allowed_ip_rangessearch_auditsearch_datasetssearch_class_relationssearch_data_accesssearch_data_lakesearch_dulesearch_query_servicesearch_sandbox_health_assessmentsearch_schema_registryexecute_observability_metrics_queryinspect_observability_breachesツールリファレンス
search_allowed_ip_ranges
リソース: Data Distiller認証・ IP範囲
ステータス: アクティブ
現在のサンドボックス内のクエリサービスに対して設定されたすべてのIP アクセス制限を取得します。 組織IDと許可されるIP範囲のリストを返します。 Data Distiller アドオンを使用しているお客様のみが利用できます。
機能: クエリサービスで許可されているIP範囲のリスト
パラメーターがありません。
search_audit
リソース:監査クエリ ・監査イベント
ステータス: アクティブ
Experience Platform サービス全体のユーザーアクティビティのタイムスタンプ付きレコードを一覧表示します。 アクションタイプ、ユーザーの電子メール、アセット情報、イベントステータスを返します。 asset_typeとactionを使用して結果を絞り込みます。 時間範囲が指定されていない場合は、デフォルトで過去7日間になります。 過去90日間の過去1000件のレコードとイベントに限定されます。
機能:監査イベントのリスト、アセットタイプ、アクション、ステータス、時間範囲、ページネーションでフィルタリング
パラメーター:
actionCreate、Delete、Update、Enable、Disableasset_typeDataset, Schema, Segment, Destination, Source Data Flow, Merge Policy, Identity Namespace, Identity Graph, Sandbox, Role, Query, Scheduled Query, Datastream, Computed Attribute, Field Group, Class, Data Types, Account, Product Profile, Query Template, Work Order, Audit Logs, Access Control Policyのいずれかである必要がありますstatusSuccess、Failure、Allow、Deny。 OR用のカンマ区切りstart_time2024-01-15T00:00:00.000Z)end_timeproperty_filteraction==create)。 上記の専用パラメーターを優先するorderbytimestamp (asc)または-timestamp (desc)limitstartquery_idsearch_datasets
リソース: カタログ API ・ データセット、バッチ
ステータス: アクティブ
Experience Platform カタログサービスの統合ディスパッチツール。 データセットのメタデータ(スキーマ参照、タグ、作成情報)またはバッチ取り込みレコード(ステータス、指標、ファイルリスト)のクエリを実行できます。 dataset/listを使用してデータセットを検索し、batch/listを使用して取り込みの正常性を確認し、batch/list_filesまたはbatch/get_meta_filesを使用して特定のバッチコンテンツを検査します。 すべての操作は読み取り専用です。
機能: データセットのリスト、データセットの取得、バッチのリスト、データセットごとの最後のバッチのリスト、バッチファイルのリスト、バッチメタファイルの取得(行エラー、入力ファイル)
パラメーター:
entity_typedataset または batchoperationlist, get, list_last, list_files, get_meta_files. 有効なコンボ:データセット→リスト、取得、5つすべて→バッチresource_iddataset/get、batch/get、batch/list_files、batch/get_meta_filesに必要query_params.limitquery_params.startquery_params.order_byasc:created,updated)。 すべてのリスト操作に適用query_params.propertiesquery_params.namequery_params.tagsunifiedProfile:enabled:true) (データセット/リストのみ)query_params.property_filterquery_params.statussuccess、failed、loading、active (バッチ/リストのみ)query_params.dataset_idquery_params.created_afterquery_params.created_beforequery_params.last_batch_statusquery_params.aggregatequery_params.pathrow_errors、input_files、row_errors_sample.json (batch/get_meta_filesのみ)search_class_relations
リソース: クラス リレーション ・静的YAML インデックス
ステータス: アクティブ
静的なclass_relations_v1.yaml インデックスを使用して、名前でExperience Platform ビジネスクラスの関係を検索します。 Experience Platform API呼び出しは行われません。 1つの用語またはコンマ区切りの用語を受け入れます。各用語は、部分的なトークン照合を使用してクラス名と照合されます。 順方向リレーション(各クラスが指す)と逆方向リレーション(クラスが指す)を持つ一致するクラスを返します。 クエリ、データフロー、スキーマコンポジションを構築する前に、エンティティの関係を把握するために使用します。
機能: トークンによる検索、複数用語のコンマ区切り検索、部分的なトークン一致、双方向の同義語拡張
パラメーター:
querydatはdataset、data_typeなどに一致します)。 複数のコンマ区切りの用語を渡して、一度に複数のクラス (例:dataset, schema)を検索します。nsearch_data_access
リソース: データ アクセス API ・失敗したバッチ
ステータス: アクティブ
Experience Platform データ取り込みに失敗したバッチからファイルにアクセスします。 失敗したバッチに属するファイルを一覧表示するには、failed_batch/list_failedを使用します。 すべての操作にバッチ IDが必要です。 注意:file/getとdataset/previewは、実際のレコードデータを公開しているため、無効になっています。 すべての操作は読み取り専用です。
機能:失敗した取り込みバッチからのファイルのリスト
パラメーター:
entity_typefailed_batch – 失敗した取り込みバッチからのファイルのリストoperationlist_failed — サポートされている操作は1つだけですresource_idquery_params.start1)query_params.limit10)query_params.pathprofiles.csv)search_data_lake
リソース: Data Lake API ・ データセット、バッチ
ステータス: アクティブ
データレイク層からデータセットとバッチメタデータを検査します。 完全なメタデータにはget、ストレージと取り込みサイズの指標にはget_size、タイムウィンドウ内の取り込み失敗を監視するにはlist_failedを使用します。 list_failedに期間が指定されていない場合は、過去7日間がデフォルトになります。 すべての操作は読み取り専用で、リソース IDが必要です。
機能: データセット/バッチメタデータの取得、ストレージサイズ指標の取得、失敗したバッチの時間枠内での一覧表示
パラメーター:
entity_typedataset または batchoperationget, get_size, list_failed. list_failedはbatch エンティティ型のみをサポートしていますresource_idlist_failedの場合:スコープを設定するためのデータセット IDが失敗しましたquery_params.created_afterquery_params.created_beforequery_params.limitquery_params.order_bydesc:created)search_dule
リソース: データガバナンス ・ ラベル、ポリシー、marketing_actions
ステータス: アクティブ
Policy Service APIに対して、データ使用ラベル、ポリシー、マーケティングアクションをクエリします。 marketing_action/evaluateを使用して、特定のラベルを持つデータに対するマーケティングアクションがガバナンスポリシーに違反するかどうかをテストします。 すべての操作は読み取り専用です。
機能: データ使用ラベルのリスト/取得、ポリシーのリスト/取得、有効なポリシーのリスト、マーケティング アクションのリスト/取得、ラベルに対するマーケティング アクションの評価
パラメーター:
entity_typelabel、policyまたはmarketing_actionoperationlist、get、list_enabled (ポリシーのみ)、evaluate (marketing_actionのみ)。 list_enabledには範囲が必要ありませんscopecore (Adobe定義)またはcustom (組織定義)です。 list、get、evaluateには必須です。list_enabledには使用されませんresource_idgetおよびevaluateに必要query_params.dule_labelsC1,C3)。 marketing_action/evaluateには必須です。policy/listにはオプションのフィルターがありますquery_params.limitquery_params.start_page.next値からのページネーション カーソルquery_params.orderbyquery_params.property_filtername==C1)query_params.marketing_actionquery_params.include_draftmarketing_action/evaluateにドラフトポリシーを含める(デフォルト:ENABLED ポリシーのみ)search_query_service
リソース: クエリサービス ・ クエリ、テンプレート、スケジュール、スケジュール実行、接続、アラートサブスクリプション
ステータス: アクティブ
Query Serviceのリソース向けの統合ツール。 アドホッククエリ、保存されたSQL テンプレート、スケジュールされたクエリとその実行、インタラクティブ接続パラメーター(psql/JDBC クライアント用)、アラートサブスクリプションのリストと取得。 クエリリストの場合は、デフォルトでisService==false,isParentLevel==trueに設定して、内部トラフィックを除外します。 すべての操作は読み取り専用です。
機能: リスト/取得クエリ、リスト/取得テンプレート、リスト/取得スケジュール、リスト/取得スケジュール実行、接続パラメーターの取得、アラート サブスクリプションのリスト
パラメーター:
entity_typequery, query_template, schedule, schedule_run, connection, alert_subscriptionoperationlist, get, get_connection_params, list_by_u...execute_observability_metrics_query
リソース: Observability Insights ・ metrics
ステータス: アクティブ
現在のサンドボックス、または組織内のすべてのサンドボックスについて、Observability Insights指標をクエリします。 1回のリクエスト、タグベースのフィルター、指標ごとのダウンサンプリングで複数の指標をサポートしています。 scope=orgの場合、すべての指標に少なくとも1つのgroupBy フィルターを含めます。 すべての操作は読み取り専用です。
機能: クエリー指標データポイント、時系列または集計、複数指標リクエスト、タグフィルター、groupBy/exclude、指標ごとのダウンサンプル
パラメーター:
metricsname (完全修飾指標名)、aggregator (sum、avg、min、max、count、last、p50、p95、p99、ヒストグラムのバリアント、またはabsent)、オプション filters、およびオプション downsampleが含まれますstart2026-01-15T00:00:00.000Z)。 endより前である必要があります。 最大ウィンドウ:31日endstart以降である必要がありますgranularityMINUTE、FIVE_MINUTE、TEN_MINUTE、FIFTEEN_MINUTE、THIRTY_MINUTE、HOUR、FOUR_HOUR、TWELVE_HOUR、DAY、TWO_DAY、WEEK、MONTHまたはALL (ウィンドウを1つの集計に折りたたむ)。 サーバーが選択することを許可しないscopesandbox (既定値)は、現在のサンドボックスをクエリします。 orgは、組織内のすべてのサンドボックスをクエリし、すべての指標にgroupBy フィルターを推奨しますmetrics[].filtersの各フィルターには、name (タグ名)、value (正確、ワイルドカード、または正規表現の一致)、オプションのgroupByおよびexcludeのブール値が含まれます。
inspect_observability_breaches
リソース: Observability Insights ・ データ侵害
ステータス: アクティブ
現在のサンドボックスまたは組織内のすべてのサンドボックスについて、指標が設定されたベースラインを超えた時間ウィンドウであるObservability Insights個の漏洩間隔を検出します。 系列ごとに一致した区間を返します。 ウィンドウの終了時にまだ進行中のオープンエンドの侵害はend: nullで返されます。 すべての操作は読み取り専用です。
機能: シリーズ、組織、サンドボックスの範囲ごとに侵害の間隔を一覧表示します
パラメーター:
metricsname (完全修飾メトリック名)とオプションのfiltersが含まれますstartendより前である必要があります。 最大ウィンドウ:31日endgranularityALLを除くexecute_observability_metrics_queryと同じ値。 各バケットは、ベースラインに対して個別に評価されますscopesandbox (デフォルト)またはorg。 サンドボックスフィルターを使用しないorgでは、指標ごとにgroupBy: trueを含むフィルターを少なくとも1つ含めることで、組織全体で折りたたまれるのではなく、そのディメンションで結果が分割されますinspect_observability_breachesはmetrics[]にaggregatorまたはdownsampleを受け入れません。 ツールは、違反条件を評価するために、これらを社内で設定します。
granularityを使用したりします。search_sandbox_health_assessment
リソース:実行と操作・ ヘルスチェック評価
ステータス: アクティブ
現在のサンドボックスの最新の「実行」および「操作」ヘルスチェック評価結果を取得します。 スキーマやID、セグメンテーション、取り込み、プロファイルなど、サポートされているあらゆるカテゴリをまたいで結果を返します。 別のルックアップを使用せずに根本原因を特定するために、各結果には、失敗したチェックの背後にある影響を受けるアセットが含まれます。 公開された人間が読み取れる名前を持つチェックのみが返されます。 すべての操作は読み取り専用です。
機能:現在のサンドボックスのすべてのヘルスチェック結果を一覧表示し、1つの名前付きチェックの結果を取得します
パラメーターがありません。