DocumentaçãoAI DocumentationIA no CX Enterprise

Ferramentas do Adobe Experience Platform no Adobe CX Co-worker Gateway aep-mcp

Última atualização: 19 de agosto de 2026

Criado para:

  • Admin
  • User
  • Developer
  • Leader

Você pode usar as ferramentas de produto do Adobe Experience Platform para inspecionar esquemas, conjuntos de dados, configuração de governança de dados, recursos do Serviço de consulta e eventos de auditoria de um cliente compatível com MCP. Essas ferramentas estão disponíveis por meio do Adobe CX Co-worker Gateway, quando sua organização está habilitada e sua conta de usuário tem as permissões necessárias do Experience Platform.

AVAILABILITY
A ferramenta do produto Experience Platform está no Beta. O acesso é apenas por convite e requer a habilitação da organização da Adobe. Consulte Acessar as ferramentas do CX Co-worker Gateway.

Resumo

Ferramenta
Descrição
Recurso
Recursos
Status
search_allowed_ip_ranges
Recuperar restrições de acesso de IP do Serviço de Consulta
Autenticação do Data Distiller · Intervalos IP
list
Ativo
search_audit
Listar eventos de auditoria de atividades do usuário no Experience Platform
Consulta de auditoria · eventos de auditoria
lista, filtrar por tipo de ativo, ação, status, intervalo de tempo
Ativo
search_datasets
Consultar metadados do conjunto de dados e da assimilação em lote
API do catálogo · Conjuntos de dados, lotes
listar, obter, filtrar, listar último, listar arquivos
Ativo
search_class_relations
Pesquisar relacionamentos de classe comercial do Experience Platform
Relações de classe · índice YAML estático
pesquisa por token, correspondência parcial de vários termos
Ativo
search_data_access
Listar arquivos de lotes de assimilação com falha
API de acesso a dados · lotes com falha
listar arquivos com falha
Ativo
search_data_lake
Inspecionar metadados do conjunto de dados e integridade do lote
API Data Lake · conjuntos de dados, lotes
obter, obter tamanho, listar lotes com falha
Ativo
search_dule
Consultar rótulos, políticas e ações de governança de dados
Controle de dados · rótulos, políticas, ações de marketing
lista, obter, lista ativada, avaliar
Ativo
search_query_service
Consulta consultas SQL, modelos, agendamentos, alertas
Serviço de consulta · consultas, modelos, agendamentos, alertas
listar, obter, filtrar, obter parâmetros de conexão
Ativo
search_sandbox_health_assessment
Recuperar os resultados mais recentes da avaliação de verificação de integridade Executar e Operar para a sandbox atual
Executar e operar · avaliações de verificação de integridade
lista, obter por nome de cheque
Ativo
search_schema_registry
Consultar esquemas XDM, grupos de campos, classes, tipos
Registro de Esquemas · esquemas, grupos de campos, classes, data_types, descritores
listar, obter, filtrar por contêiner
Ativo
execute_observability_metrics_query
Consultar Observability Insights métricas para a sandbox atual ou em todas as sandboxes
Insights de observação · métricas
séries de tempo e consultas agregadas, solicitações multimétricas, filtros de tag, groupBy/exclude, downsample por métrica
Ativo
inspect_observability_breaches
Detectar Observability Insights intervalos de violação em que uma métrica excedeu sua linha de base configurada
Insights de capacidade de observação · violações
listar intervalos de violação por série, organização e escopo da sandbox
Ativo

Referência da ferramenta

search_allowed_ip_ranges

Recurso: Autenticação do Data Distiller · Intervalos IP
Status: Ativo

Recupere todas as restrições de acesso IP configuradas para o Serviço de consulta na sandbox atual. Retorna a ID da organização e a lista de intervalos de IP permitidos. Disponível somente para clientes com o complemento Data Distiller.

Recursos: listar intervalos IP permitidos para o Serviço de Consulta

Nenhum parâmetro.

search_audit

Recurso: Consulta de auditoria · eventos de auditoria
Status: Ativo

Lista registros com carimbo de data e hora de atividades do usuário nos serviços da Experience Platform. Retorna o tipo de ação, email do usuário, informações do ativo e status do evento. Use asset_type e action para restringir os resultados. O padrão é os últimos 7 dias quando nenhum intervalo de tempo é especificado. Limitado aos últimos 1000 registros e eventos dos últimos 90 dias.

Recursos: liste eventos de auditoria, filtre por tipo de ativo, ação, status, intervalo de tempo, paginar

Parâmetros:

Parâmetro
Obrigatório
Descrição
action
Não
Filtrar por tipo de ação. Valores comuns (separados por vírgula para OR): Create, Delete, Update, Enable, Disable
asset_type
Não
Filtrar por tipo de ativo. Deve ser um dos seguintes: 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
Não
Filtrar por status do evento. Valores: Success, Failure, Allow, Deny. Separado por vírgulas para OR
start_time
Não
Carimbo de data e hora mais antigo. ISO 8601 UTC com ms, ex.: 2024-01-15T00:00:00.000Z
end_time
Não
Carimbo de data/hora mais recente. ISO 8601 UTC com ms
property_filter
Não
Expressão de filtro bruta, ex.: action==create. Preferir os parâmetros dedicados acima
orderby
Não
Ordem de classificação: timestamp (asc) ou -timestamp (desc)
limit
Não
Número máximo de resultados (3-1000, padrão 50)
start
Não
Deslocamento de paginação. Incrementar por valor de limite para cada página
query_id
Não
ID da consulta de uma resposta anterior para repetir a mesma consulta

search_datasets

Recurso: API de catálogo · dataSets, lotes
Status: Ativo

Ferramenta de expedição unificada para o serviço de catálogo da Experience Platform. Consultar metadados do conjunto de dados (referências de esquema, tags, informações de criação) ou registros de assimilação em lote (status, métricas, listagens de arquivos). Use dataset/list para descobrir conjuntos de dados, batch/list para verificar a integridade da assimilação e batch/list_files ou batch/get_meta_files para inspecionar conteúdo de lote específico. Todas as operações são somente leitura.

Recursos: listar conjuntos de dados, obter conjunto de dados, listar lotes, obter lote, listar o último lote por conjunto de dados, listar arquivos em lotes, obter metarquivos em lotes (erros de linha, arquivos de entrada)

Parâmetros:

Parâmetro
Obrigatório
Descrição
entity_type
Sim
dataset ou batch
operation
Sim
list, get, list_last, list_files, get_meta_files. Combinações válidas: conjunto de dados → lista, get; lote → todos os cinco
resource_id
Não
Conjunto de dados ou ID do lote. Necessário para dataset/get, batch/get, batch/list_files, batch/get_meta_files
query_params.limit
Não
Máximo de resultados por página (máx. 100). Aplica-se a todas as operações de lista
query_params.start
Não
Deslocamento de paginação. Aplica-se a todas as operações de lista
query_params.order_by
Não
Direção de classificação, por exemplo, asc:created,updated. Aplica-se a todas as operações de lista
query_params.properties
Não
Incluo na lista de permissões de propriedades separado por vírgulas. Aplica-se a dataset/list, dataset/get, batch/list, batch/list_last
query_params.name
Não
Filtrar conjuntos de dados por nome (somente conjunto de dados/lista)
query_params.tags
Não
Filtrar conjuntos de dados por marcas, por exemplo unifiedProfile:enabled:true (somente conjunto de dados/lista)
query_params.property_filter
Não
Filtro Regex em objetos de resposta (conjunto de dados/lista e lote/lista)
query_params.status
Não
Filtrar lotes por status: success, failed, loading, active (somente lote/lista)
query_params.dataset_id
Não
Escopo lotes para um conjunto de dados específico (batch/list e batch/list_last)
query_params.created_after
Não
Filtrar lotes criados após o carimbo de data e hora Unix em ms (somente lote/lista)
query_params.created_before
Não
Filtrar lotes criados antes do carimbo de data e hora Unix em ms (somente lote/lista)
query_params.last_batch_status
Não
Filtrar por status do último lote (somente batch/list_last)
query_params.aggregate
Não
Retornar métricas agregadas no nível raiz (somente batch/get)
query_params.path
Não
Arquivo Meta a ser baixado: row_errors, input_files, row_errors_sample.json (batch/get_meta_files somente)

search_class_Relations

Recurso: Relações de Classe · índice YAML estático
Status: Ativo

Procure relações de classe comercial da Experience Platform por nome usando o índice estático class_relations_v1.yaml. Não são feitas chamadas à API da Experience Platform. Aceita um único termo ou termos separados por vírgulas; cada termo é comparado a nomes de classe usando a correspondência de token parcial. Retorna classes correspondentes com relações de encaminhamento (para o que cada classe aponta) e relações de reversão (para as quais as classes apontam de volta). Use-a para entender os relacionamentos de entidade antes de criar consultas, fluxos de dados ou composições de esquema.

Recursos: pesquisa por token, pesquisa separada por vírgulas multitermo, correspondência de token parcial, expansão de sinônimo bidirecional

Parâmetros:

Parâmetro
Obrigatório
Descrição
query
Sim
Nome da classe comercial ou tipo de objeto a ser pesquisado. Suporta correspondências parciais de token (dat correspondências dataset, data_type, etc.). Passe vários termos separados por vírgula para procurar várias classes de uma só vez (por exemplo, dataset, schema)
n
Não
Número máximo de resultados correspondentes a serem retornados (padrão: 5, min 1)

search_data_access

Recurso: API de acesso a dados · lotes com falha
Status: Ativo

Acesse arquivos de lotes de assimilação de dados com falha da Experience Platform. Use failed_batch/list_failed para listar os arquivos pertencentes a um lote com falha para diagnóstico de falha. Requer uma ID de lote para todas as operações. Observação: file/get e dataset/preview estão desabilitados porque expõem os dados reais do registro. Todas as operações são somente leitura.

Recursos: listam arquivos de um lote de assimilação com falha

Parâmetros:

Parâmetro
Obrigatório
Descrição
entity_type
Sim
failed_batch — listar arquivos de um lote de assimilação com falha
operation
Sim
list_failed — a única operação suportada
resource_id
Sim
ID do lote com falha
query_params.start
Não
Índice de início de paginação, ex.: 1
query_params.limit
Não
Número de resultados por página, por exemplo: 10
query_params.path
Não
Filtro de nome de arquivo completo, ex.: profiles.csv

search_data_lake

Recurso: API Data Lake · conjuntos de dados, lotes
Status: Ativo

Inspecione o conjunto de dados e os metadados em lote da camada do Data Lake. Use get para metadados completos, get_size para métricas de tamanho de armazenamento e assimilação e list_failed para monitorar falhas de assimilação em uma janela de tempo. O padrão é os últimos 7 dias quando nenhum intervalo de tempo é fornecido para list_failed. Todas as operações são somente leitura e exigem uma ID de recurso.

Recursos: obtenha metadados de conjunto de dados/lote, obtenha métricas de tamanho de armazenamento, liste lotes com falha em uma janela de tempo

Parâmetros:

Parâmetro
Obrigatório
Descrição
entity_type
Sim
dataset ou batch
operation
Sim
get, get_size, list_failed. list_failed dá suporte apenas ao tipo de entidade batch
resource_id
Sim
ID do conjunto de dados ou ID do lote. Para list_failed: a ID do conjunto de dados para analisar falhas para
query_params.created_after
Não
Janela de início de hora. Carimbo de data e hora Unix em ms
query_params.created_before
Não
Fim da janela de tempo. Carimbo de data e hora Unix em ms
query_params.limit
Não
Máximo de resultados por página (máx. 100)
query_params.order_by
Não
Direção de classificação, ex.: desc:created

search_dule

Recurso: Governança de dados · rótulos, políticas, ações_de_marketing
Status: Ativo

Consulte a API de serviço de política para obter os rótulos de uso de dados, as políticas e as ações de marketing. Use marketing_action/evaluate para testar se uma ação de marketing em dados com rótulos específicos violaria quaisquer políticas de governança. Todas as operações são somente leitura.

Recursos: listar/obter rótulos de uso de dados, listar/obter políticas, listar políticas habilitadas, listar/obter ações de marketing, avaliar a ação de marketing em relação aos rótulos

Parâmetros:

Parâmetro
Obrigatório
Descrição
entity_type
Sim
label, policy ou marketing_action
operation
Sim
list, get, list_enabled (somente política), evaluate (somente marketing_action). list_enabled não requer escopo
scope
Não
core (definido pela Adobe) ou custom (definido pela organização). Necessário para list, get, evaluate; não usado para list_enabled
resource_id
Não
Nome do rótulo, ID da política ou nome da ação de marketing. Necessário para get e evaluate
query_params.dule_labels
Não
Rótulos separados por vírgulas (ex.: C1,C3). Necessário para marketing_action/evaluate; filtro opcional para policy/list
query_params.limit
Não
Máximo de resultados
query_params.start
Não
Cursor de paginação do valor _page.next de uma resposta anterior
query_params.orderby
Não
Campos de classificação separados por vírgulas
query_params.property_filter
Não
Expressão de filtro, ex.: name==C1
query_params.marketing_action
Não
Restringir a lista de políticas a políticas que fazem referência a esta ação de marketing (somente política/lista)
query_params.include_draft
Não
Incluir políticas RASCUNHO em marketing_action/evaluate (padrão: somente políticas HABILITADAS)

search_query_service

Recurso: Serviço de Consulta · consultas, modelos, agendamentos, execuções de agendamento, conexões, assinaturas de alerta
Status: Ativo

Ferramenta unificada para recursos do Serviço de consulta. Liste e recupere consultas ad-hoc, modelos SQL salvos, consultas programadas e suas execuções, parâmetros de conexão interativa (para clientes psql/JDBC) e assinaturas de alerta. Para listas de consulta, o padrão é isService==false,isParentLevel==true para filtrar o tráfego interno. Todas as operações são somente leitura.

Recursos: consultas list/get, modelos list/get, agendamentos list/get, execuções de agendamento list/get, obter parâmetros de conexão, listar assinaturas de alerta

Parâmetros:

Parâmetro
Obrigatório
Descrição
entity_type
Sim
query, query_template, schedule, schedule_run, connection, alert_subscription
operation
Sim
list, get, get_connection_params, list_by_u...

execute_observability_metrics_query

Recurso: Insights de observação · métricas
Status: Ativo

Consulte Observability Insights métricas para a sandbox atual ou para todas as sandboxes da sua organização. Suporta várias métricas em uma única solicitação, filtros baseados em tags e redução de resolução por métrica. Para scope=org, inclua pelo menos um filtro groupBy em cada métrica. Todas as operações são somente leitura.

Recursos: pontos de dados de métrica de consulta, série de tempo ou agregação, solicitações de várias métricas, filtros de marca, groupBy/exclude, downsample de cada métrica

Parâmetros:

Parâmetro
Obrigatório
Descrição
metrics
Sim
Matriz de especificações de métrica. Cada uma inclui name (nome de métrica totalmente qualificado), aggregator (sum, avg, min, max, count, last, p50, p95, p99, variantes de histograma ou absent), filters opcional e downsample opcional
start
Sim
Início da janela, ISO 8601, ex.: 2026-01-15T00:00:00.000Z. Deve ser anterior a end. Janela máxima: 31 dias
end
Sim
Fim da janela, ISO 8601. Deve ser posterior a start
granularity
Não
Tamanho do intervalo de tempo: MINUTE, FIVE_MINUTE, TEN_MINUTE, FIFTEEN_MINUTE, THIRTY_MINUTE, HOUR, FOUR_HOUR, TWELVE_HOUR, DAY, TWO_DAY, WEEK, MONTH ou ALL (recolhe a janela em uma única agregação). Omitir para permitir que o servidor escolha
scope
Não
sandbox (padrão) consulta a sandbox atual. org consulta todas as sandboxes na sua organização e recomenda um filtro groupBy em cada métrica

Cada filtro em metrics[].filters inclui um name (nome da marca), value (correspondência exata, curinga ou regex) e booleanos groupBy e exclude opcionais.

inspect_observability_breaches

Recurso: Insights de capacidade de observação · violações
Status: Ativo

Detectar Observability Insights intervalos de violação, as janelas de tempo em que uma métrica excedeu sua linha de base configurada, para a sandbox atual ou em todas as sandboxes na sua organização. Retorna intervalos pré-correspondidos por série. Violações abertas ainda em andamento no final da janela são retornadas com end: null. Todas as operações são somente leitura.

Recursos: intervalos de violação de lista por série, organização e escopo de sandbox

Parâmetros:

Parâmetro
Obrigatório
Descrição
metrics
Sim
Conjunto de especificações de violação. Cada uma inclui name (nome de métrica totalmente qualificado) e filters opcional
start
Sim
Início da janela, ISO 8601. Deve ser anterior a end. Janela máxima: 31 dias
end
Sim
Extremidade da janela, ISO 8601
granularity
Não
Tamanho do bucket de tempo, mesmos valores de execute_observability_metrics_query exceto ALL. Cada bucket é avaliado independentemente em relação à linha de base
scope
Não
sandbox (padrão) ou org. Em org sem um filtro de sandbox, inclua pelo menos um filtro com groupBy: true por métrica para que os resultados sejam divididos por essa dimensão em vez de recolhidos pela organização

inspect_observability_breaches não aceita aggregator ou downsample em metrics[]. A ferramenta os define internamente para avaliar a condição de violação.

NOTE
Ambas as ferramentas do Observability Insights também estão limitadas a cerca de 10.000 pontos de dados por solicitação. Restrinja o intervalo de tempo, adicione filtros ou use granularity mais grosso se uma solicitação for rejeitada por exceder esse limite.

search_sandbox_health_assessment

Recurso: Executar e Operar · avaliações de verificação de integridade
Status: Ativo

Recupere os resultados mais recentes da avaliação de verificação de integridade Executar e Operar para a sandbox atual. Retorna resultados em todas as categorias compatíveis, incluindo esquemas e identidades, segmentação, assimilação e perfil. Para identificar a causa raiz sem uma pesquisa separada, cada resultado inclui os ativos afetados por trás de uma verificação com falha. Somente as verificações com um nome publicado e legível são retornadas. Todas as operações são somente leitura.

NOTE
Essa ferramenta recupera apenas os resultados da avaliação. Para corrigir um problema sinalizado, use o painel de detalhes da verificação de integridade na interface do usuário do Experience Platform. Consulte Verificações de integridade. As orientações de correção automática para verificações de integridade com suporte estão disponíveis como uma habilidade no CX Coworker Chat.

Recursos: lista todos os resultados da verificação de integridade da sandbox atual, obtém resultados para uma verificação nomeada

Nenhum parâmetro.

recommendation-more-help
cx-enterprise-ai-help