Adobe CX Coworker Gateway의 Adobe Experience Platform 툴 aep-mcp

Adobe Experience Platform 제품 도구를 사용하여 MCP 호환 클라이언트에서 스키마, 데이터 세트, 데이터 거버넌스 구성, 쿼리 서비스 리소스 및 감사 이벤트를 검사할 수 있습니다. 이러한 도구는 조직이 활성화되고 사용자 계정에 필요한 Experience Platform 권한이 있는 경우 Adobe CX Coworker Gateway를 통해 사용할 수 있습니다.

AVAILABILITY
Experience Platform 제품 도구는 Beta에 있습니다. 액세스는 초대를 통해서만 가능하며 Adobe 조직 활성화가 필요합니다. CX Coworker 게이트웨이 도구 액세스를 참조하십시오.

요약

도구
설명
리소스
기능
상태
search_allowed_ip_ranges
쿼리 서비스 IP 액세스 제한 검색
데이터 Distiller 인증 · IP 범위
list
활성
search_audit
Experience Platform의 사용자 활동 감사 이벤트 나열
쿼리 감사 · 이벤트 감사
목록, 자산 유형별 필터링, 작업, 상태, 시간 범위
활성
search_datasets
쿼리 데이터 세트 및 일괄 처리 수집 메타데이터
카탈로그 API · 데이터 세트, 배치
list, get, filter, list last, list files
활성
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의 경우 쉼표로 구분): Create, Delete, Update, Enable, Disable
asset_type
아니오
자산 유형별로 필터링합니다. Dataset, 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 중 하나여야 합니다.
status
아니오
이벤트 상태별로 필터링합니다. 값: Success, Failure, Allow, Deny. OR의 경우 쉼표로 구분
start_time
아니오
가장 빠른 타임스탬프입니다. ms가 포함된 ISO 8601 UTC, 예: 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_files 또는 batch/get_meta_files을(를) 사용합니다. 모든 작업은 읽기 전용입니다.

기능: 데이터 세트 나열, 데이터 세트 가져오기, 배치 나열, 데이터 세트당 마지막 배치 나열, 배치 파일 나열, 배치 메타 파일 가져오기(행 오류, 입력 파일)

매개 변수:

매개 변수
필수 여부
설명
entity_type
dataset 또는 batch
operation
list, get, list_last, list_files, get_meta_files. 유효한 조합: 데이터 세트 → 목록, 가져오기, 5개 모두→ 일괄 처리
resource_id
아니오
데이터 세트 또는 배치 ID. dataset/get, batch/get, batch/list_files, batch/get_meta_files에 필요
query_params.limit
아니오
페이지당 최대 결과 수(최대 100개). 모든 목록 작업에 적용됩니다.
query_params.start
아니오
페이지 매김 오프셋입니다. 모든 목록 작업에 적용됩니다.
query_params.order_by
아니오
정렬 방향(예: asc:created,updated). 모든 목록 작업에 적용됩니다.
query_params.properties
아니오
쉼표로 구분된 속성. 데이터 세트/목록, 데이터 세트/get, batch/list, batch/list_last에 적용
query_params.name
아니오
이름별로 데이터 세트 필터링(데이터 세트/목록만)
query_params.tags
아니오
태그로 데이터 세트 필터링(예: unifiedProfile:enabled:true) (데이터 세트/목록만)
query_params.property_filter
아니오
응답 개체(데이터 세트/목록 및 배치/목록)에 대한 정규 표현식 필터
query_params.status
아니오
상태별로 일괄 처리 필터링: success, failed, loading, active(일괄 처리/목록만)
query_params.dataset_id
아니오
특정 데이터 세트(batch/list 및 batch/list_last)에 배치 범위 지정
query_params.created_after
아니오
Unix 타임스탬프 이후 생성된 일괄 처리 필터링(ms)(일괄 처리/목록만 해당)
query_params.created_before
아니오
Unix 타임스탬프 전에 생성된 일괄 처리 필터링(밀리초)(일괄 처리/목록만 해당)
query_params.last_batch_status
아니오
마지막 배치 상태로 필터링(batch/list_last만)
query_params.aggregate
아니오
루트 수준에서 집계된 지표 반환(일괄 처리/가져오기 전용)
query_params.path
아니오
다운로드할 Meta 파일: row_errors, input_files, row_errors_sample.json(batch/get_meta_files만 해당)

search_class_relations

리소스: 클래스 관계 · 정적 YAML 인덱스
상태: 활성

정적 class_relations_v1.yaml 인덱스를 사용하여 이름별로 Experience Platform 비즈니스 클래스 관계를 검색합니다. Experience Platform API 호출이 수행되지 않습니다. 하나의 용어나 쉼표로 구분된 용어를 허용합니다. 부분 토큰 일치를 사용하여 각 용어를 클래스 이름에 대해 일치시킵니다. 정방향 관계(각 클래스가 가리키는 대상) 및 역방향 관계(해당 클래스를 다시 가리키는 대상)와 일치하는 클래스를 반환합니다. 쿼리, 데이터 흐름 또는 스키마 구성을 작성하기 전에 엔티티 관계를 이해하려면 이 함수를 사용하십시오.

기능: 토큰별 검색, 여러 단어로 이루어진 쉼표로 구분된 검색, 부분 토큰 일치, 양방향 동의어 확장

매개 변수:

매개 변수
필수 여부
설명
query
검색할 비즈니스 클래스 이름 또는 개체 유형입니다. 부분 토큰 일치(dat개가 dataset, data_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

리소스: Data Lake API · 데이터 세트, 배치
상태: 활성

데이터 레이크 레이어에서 데이터 세트 및 배치 메타데이터를 검사합니다. 전체 메타데이터에 get, 저장소 및 수집 크기 지표에 get_size, 기간 내에 수집 실패를 모니터링하려면 list_failed을(를) 사용합니다. list_failed에 대한 시간 범위가 제공되지 않은 경우 기본값은 지난 7일로 설정됩니다. 모든 작업은 읽기 전용이며 리소스 ID가 필요합니다.

기능: 데이터 세트/일괄 처리 메타데이터 가져오기, 저장소 크기 지표 가져오기, 실패한 일괄 처리 나열 시간 내

매개 변수:

매개 변수
필수 여부
설명
entity_type
dataset 또는 batch
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

리소스: 데이터 거버넌스 · 레이블, 정책, 마케팅 액션
상태: 활성

데이터 사용 레이블, 정책 및 마케팅 작업에 대해 Policy Service API 를 쿼리합니다. 특정 레이블이 있는 데이터에 대한 마케팅 작업이 거버넌스 정책을 위반하는지 여부를 테스트하려면 marketing_action/evaluate을(를) 사용합니다. 모든 작업은 읽기 전용입니다.

기능: 목록/데이터 사용 레이블 가져오기, 목록/정책 가져오기, 목록 사용 정책, 목록/마케팅 작업 가져오기, 레이블에 대한 마케팅 작업 평가

매개 변수:

매개 변수
필수 여부
설명
entity_type
label, policy 또는 marketing_action
operation
list, get, list_enabled(정책만), evaluate(marketing_action만). list_enabled에는 범위가 필요하지 않습니다.
scope
아니오
core(Adobe 정의) 또는 custom(org 정의). list, get, evaluate에 필요; 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에 초안 정책 포함(기본값: ENABLED 정책만)

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