Adobe CX Co-worker Gateway中的Adobe Experience Platform工具 aep-mcp

您可以使用Adobe Experience Platform产品工具从与MCP兼容的客户端检查架构、数据集、数据管理配置、查询服务资源和审核事件。 当您的组织已启用,并且您的用户帐户具有所需的Experience Platform权限时,可以通过Adobe CX Co-worker Gateway使用这些工具。

AVAILABILITY
Experience Platform产品工具位于Beta中。 访问仅通过邀请进行,并且需要Adobe组织启用。 请参阅访问CX Co-worker网关工具

概要

工具
描述
资源
功能
状态
search_allowed_ip_ranges
检索查询服务IP访问限制
数据Distiller身份验证· IP范围
list
活动
search_audit
列出Experience Platform中的用户活动审核事件
审核查询·审核事件
列表,按资源类型筛选,操作,状态,时间范围
活动
search_datasets
查询数据集和批量摄取元数据
目录API ·数据集、批次
列表,获取,筛选,列出最后一个,列出文件
活动
search_class_relations
搜索Experience Platform企业级关系
类关系·静态YAML索引
按令牌、多词、部分匹配搜索
活动
search_data_access
列出失败摄取批次中的文件
数据访问API ·失败的批处理
列出失败的文件
活动
search_data_lake
检查数据集元数据和批次运行状况
Data Lake API ·数据集、批次
获取,获取大小,列出失败的批次
活动
search_dule
查询数据管理标签、策略和操作
数据管理·标签、策略、营销活动
列表,获取,列表启用,评估
活动
search_query_service
查询SQL查询、模板、计划、警报
查询服务·查询、模板、计划、警报
列表,获取,筛选,获取连接参数
活动
search_schema_registry
查询XDM架构、字段组、类、类型
架构注册表·架构、字段组、类、数据类型、描述符
列表,获取,按容器筛选
活动

工具引用

search_allowed_ip_ranges

资源:​数据Distiller身份验证· IP范围
状态:​活动

在当前沙盒中为查询服务检索所有配置的IP访问限制。 返回组织ID和允许的IP范围列表。 仅适用于具有Data Distiller加载项的客户。

功能:​列出查询服务的允许IP范围

无参数。

search_audit

资源:​审核查询·审核事件
状态:​活动

列出跨Experience Platform服务的用户活动带有时间戳的记录。 返回操作类型、用户电子邮件、资产信息和事件状态。 使用asset_typeaction缩小结果范围。 未指定时间范围时,默认为最近7天。 限于过去90天的最近1000条记录和事件。

功能:​列出审核事件,按资源类型筛选,操作,状态,时间范围,分页

参数:

参数
必需
描述
action
按操作类型过滤。 常用值(OR以逗号分隔): CreateDeleteUpdateEnableDisable
asset_type
按资源类型筛选。 必须为: DatasetSchemaSegmentDestinationSource Data FlowMerge PolicyIdentity NamespaceIdentity GraphSandboxRoleQueryScheduled QueryDatastreamComputed AttributeField GroupClassData TypesAccountProduct ProfileQuery TemplateWork OrderAudit LogsAccess Control Policy之一
status
按事件状态筛选。 值: SuccessFailureAllowDeny。 OR的逗号分隔
start_time
最早的时间戳。 ISO 8601 UTC和ms,例如2024-01-15T00:00:00.000Z
end_time
最新时间戳。 ISO 8601 UTC,带ms
property_filter
原始筛选器表达式,如action==create。 首选上述专用参数
orderby
排序顺序: timestamp (asc)或-timestamp (desc)
limit
最大结果数(3-1000,默认为50)
start
分页偏移。 每页按限制值递增
query_id
来自先前响应的查询ID以重复相同查询

search_dataset

资源:​目录API ·数据集、批次
状态:​活动

Experience Platform目录服务的统一调度工具。 查询数据集元数据(架构引用、标记、创建信息)或批量摄取记录(状态、量度、文件列表)。 使用dataset/list发现数据集,batch/list检查摄取运行状况,以及batch/list_filesbatch/get_meta_files检查特定批次内容。 所有操作均为只读。

功能:​列出数据集,获取数据集,列出批次,获取批次,为每个数据集列出上一批次,列出批处理文件,获取批处理元文件(行错误,输入文件)

参数:

参数
必需
描述
entity_type
datasetbatch
operation
list, get, list_last, list_files, get_meta_files. 有效的组合:数据集→ list, get;批次→全部五个
resource_id
数据集或批次ID。 dataset/getbatch/getbatch/list_filesbatch/get_meta_files必需
query_params.limit
每页最大结果数(最多100个)。 应用于所有列表操作
query_params.start
分页偏移。 应用于所有列表操作
query_params.order_by
排序方向,如asc:created,updated。 应用于所有列表操作
query_params.properties
逗号分隔的属性允许列表。 适用于数据集/列表、数据集/获取、批处理/列表、批处理/list_last
query_params.name
按名称筛选数据集(仅限数据集/列表)
query_params.tags
按标记(如unifiedProfile:enabled:true)筛选数据集 (仅限数据集/列表)
query_params.property_filter
对响应对象(数据集/列表和批处理/列表)进行正则表达式筛选
query_params.status
按状态筛选批次: successfailedloadingactive(仅限批次/列表)
query_params.dataset_id
将批次范围设定为特定数据集(批次/列表和batch/list_last)
query_params.created_after
筛选在Unix时间戳之后创建的批次(以毫秒为单位)(仅限批次/列表)
query_params.created_before
筛选在Unix时间戳之前(以毫秒为单位)创建的批次(仅限批次/列表)
query_params.last_batch_status
按上一批次状态筛选(仅限batch/list_last)
query_params.aggregate
返回根级别的汇总量度(仅限批处理/获取)
query_params.path
要下载的Meta文件: row_errorsinput_filesrow_errors_sample.json(仅限batch/get_meta_files)

search_class_relations

资源:​类关系·静态YAML索引
状态:​活动

使用静态class_relations_v1.yaml索引按名称搜索Experience Platform业务类关系。 未调用Experience Platform API。 接受单个术语或以逗号分隔的术语;每个术语使用部分令牌匹配根据类名进行匹配。 返回具有正向关系(每个类指向的内容)和反向关系(哪些类指向它)的匹配类。 在构建查询、数据流或架构组合之前,请使用此项了解实体关系。

功能:​按令牌搜索、多词逗号分隔搜索、部分令牌匹配、双向同义词扩展

参数:

参数
必需
描述
query
要搜索的业务类名称或对象类型。 支持部分令牌匹配(datdatasetdata_type等匹配)。 传递多个以逗号分隔的词以同时搜索多个类(例如dataset, schema
n
要返回的最大匹配结果数(默认为5,最小为1)

search_data_access

资源:​数据访问API ·失败的批处理
状态:​活动

从失败的Experience Platform数据摄取批次访问文件。 使用failed_batch/list_failed列出属于失败批次的文件以进行故障诊断。 所有操作都需要批次ID。 注意: file/getdataset/preview已禁用,因为它们公开实际记录数据。 所有操作均为只读。

功能:​从失败的引入批次中列出文件

参数:

参数
必需
描述
entity_type
failed_batch — 列出失败引入批次中的文件
operation
list_failed — 唯一支持的操作
resource_id
失败批次的批次ID
query_params.start
分页起始索引,如1
query_params.limit
每页的结果数,如10
query_params.path
完整文件名筛选器,如profiles.csv

search_data_lake

资源:​数据湖API ·数据集,批次
状态:​活动

检查数据湖层中的数据集并批处理元数据。 使用get表示完整的元数据,使用get_size表示存储和摄取大小量度,使用list_failed监视时间范围内的摄取失败。 如果未为list_failed提供时间范围,则默认为过去7天。 所有操作均为只读,需要资源ID。

功能:​获取数据集/批次元数据,获取存储大小量度,在一个时间范围内列出失败的批次

参数:

参数
必需
描述
entity_type
datasetbatch
operation
get, get_size, list_failed. list_failed仅支持batch实体类型
resource_id
数据集ID或批次ID。 对于list_failed:要将故障范围设定为的数据集ID
query_params.created_after
时间窗口的开始。 Unix时间戳(以毫秒为单位)
query_params.created_before
时间窗口结束。 Unix时间戳(以毫秒为单位)
query_params.limit
每页最大结果数(最多100个)
query_params.order_by
排序方向,如desc:created

search_dule

资源:​数据管理·标签、策略、marketing_actions
状态:​活动

查询策略服务API,以获取数据使用标签、策略和营销操作。 使用marketing_action/evaluate测试对具有特定标签的数据的营销操作是否会违反任何治理策略。 所有操作均为只读。

功能:​列出/获取数据使用标签,列出/获取策略,列出启用的策略,列出/获取营销操作,根据标签评估营销操作

参数:

参数
必需
描述
entity_type
labelpolicymarketing_action
operation
listgetlist_enabled(仅限策略)、evaluate(仅限于marketing_action)。 list_enabled不需要作用域
scope
core (Adobe定义)或custom (组织定义)。 listgetevaluate必需;未用于list_enabled
resource_id
标签名称、策略ID或营销操作名称。 getevaluate必需
query_params.dule_labels
逗号分隔的标签(如C1,C3)。 marketing_action/evaluate必需;policy/list的可选筛选器
query_params.limit
最大结果数
query_params.start
来自先前响应的_page.next值的分页光标
query_params.orderby
逗号分隔的排序字段
query_params.property_filter
筛选表达式,如name==C1
query_params.marketing_action
将策略列表限制为引用此营销操作的策略(仅限策略/列表)
query_params.include_draft
marketing_action/evaluate中包含草稿策略(默认:仅启用策略)

search_query_service

资源:​查询服务·查询、模板、计划、计划运行、连接、警报订阅
状态:​活动

查询服务资源的统一工具。 列出和检索临时查询、保存的SQL模板、计划的查询及其运行、交互式连接参数(用于psql/JDBC客户端)和警报订阅。 对于查询列表,默认为isService==false,isParentLevel==true以过滤掉内部流量。 所有操作均为只读。

功能:​列表/获取查询、列表/获取模板、列表/获取计划、列表/获取计划运行、获取连接参数、列出警报订阅

参数:

参数
必需
描述
entity_type
query, query_template, schedule, schedule_run, connection, alert_subscription
operation
list, get, get_connection_params, list_by_u...
recommendation-more-help
cx-enterprise-ai-help