[Beta]{class="badge informative"}
Referência de ferramentas do servidor MCP Adobe Target target-mcp-tools-reference
Esta página é uma referência completa para todas as ferramentas somente leitura expostas pelo servidor MCP Adobe Target. Para cada ferramenta, você encontrará uma descrição, detalhes do parâmetro, valor de retorno e um exemplo de prompt em linguagem natural. Para obter instruções de configuração e casos de uso, consulte Introdução e Casos de uso e apresentações.
Pré-requisitos tools-prerequisites
Sua função Adobe Target determina quais ferramentas estão disponíveis para você:
- Função de Observador ou superior: acesso a todas as 23 ferramentas somente leitura
Para obter instruções completas sobre a configuração, consulte Introdução.
Ferramentas de atividade tools-activities
Ferramenta: list_target_activities
Listar Adobe Target atividades com filtragem e classificação do lado do servidor.
Recupera uma lista paginada de atividades. Todos os filtros são aplicados no lado do servidor pela API de Administração Target. O servidor retorna no máximo 200 atividades por página.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
limit |
número inteiro | Não | Número máximo de atividades a serem retornadas (máx. do servidor: 200) |
offset |
número inteiro | Não | Número de atividades a serem ignoradas para paginação |
sort_by |
string | Não | Campo de acordo com o qual classificar. Prefixo com - para ordem decrescente (por exemplo, -modifiedAt). Opções: id, name, state, priority, startsAt, endsAt, lifetimeStart, lifetimeEnd, createdAt, createdBy, modifiedAt, modifiedBy, type, thirdPartyId |
state |
string | Não | Filtrar por estado de atividade: approved (ativo/ativo), deactivated (inativo), paused, saved (rascunho) |
activity_type |
string | Não | Filtrar por tipo: ab (Teste A/B), xt (Direcionamento de experiência), abt (Automated Personalization) |
name_contains |
string | Não | Filtrar atividades cujo nome contém esta cadeia de caracteres (não diferencia maiúsculas de minúsculas) |
starts_after |
string | Não | Data ISO 8601 — atividades que começam após esta data |
starts_before |
string | Não | Data ISO 8601 — atividades que começam antes desta data |
modified_after |
string | Não | Data ISO 8601 — atividades modificadas após esta data |
ends_after |
string | Não | Data ISO 8601 — atividades que terminam após esta data |
ends_before |
string | Não | Data ISO 8601 — atividades que terminam antes desta data |
workspace |
string | Não | Filtrar por ID de espaço de trabalho |
segment_id |
string | Não | Filtrar por ID de segmento de público |
profile_attribute_id |
string | Não | Filtrar por ID de atributo de perfil |
priority |
número inteiro | Não | Filtrar por valor de prioridade exato (0-999) |
mbox |
string | Não | Filtrar por nome de mbox/local |
offer_id |
string | Não | Filtrar por ID de oferta |
view_id |
string | Não | Filtrar por ID de exibição de SPA |
Retorna: objeto JSON com activities (lista de objetos incluindo id, name, state, type, priority, modifiedAt, startsAt, endsAt) e total (contagem total, pode exceder o tamanho da página retornada).
Prompt de exemplo: “Lista todos os testes A/B ativos classificados pela última modificação.”
Ferramenta: get_ab_activity
Obtenha informações detalhadas sobre uma atividade A/B.
Recupera a configuração completa de um teste A/B específico, incluindo experiências, locais, métricas e regras de direcionamento.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade A/B |
Retorna: Detalhes completos da atividade, incluindo metadados (nome, estado, prioridade, datas), experiências, locais e ofertas, metas e métricas, além das regras de direcionamento.
Prompt de exemplo: “Obter detalhes da atividade A/B 12345”.
Ferramenta: get_xt_activity
Obtenha informações detalhadas sobre uma atividade de Direcionamento de experiência (XT).
Recupera a configuração completa de uma atividade de XT específica, incluindo mapeamentos de experiência de público-alvo, locais e métricas.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade de XT |
Retorna: detalhes completos da atividade, incluindo metadados, experiências com mapeamentos de público-alvo, locais e ofertas, metas e métricas.
Prompt de exemplo: “Obter detalhes da atividade de Direcionamento de Experiência 12345”.
Ferramenta: get_abt_activity
Obtenha informações detalhadas sobre uma atividade de Automated Personalization (AP).
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade de AP |
Retorna: detalhes completos da atividade, incluindo metadados, experiências, locais e configurações algorítmicas.
Prompt de exemplo: “Obter detalhes da atividade 12345 do Personalization Automático”.
Ferramentas de oferta tools-offers
Ferramenta: list_target_offers
Liste todas as ofertas em seu locatário do Target.
Recupera uma lista paginada de ofertas de conteúdo com filtragem opcional.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
limit |
número inteiro | Não | Número máximo de ofertas a serem retornadas |
offset |
número inteiro | Não | Número de ofertas a serem ignoradas para paginação |
type |
string | Não | Filtrar por tipo de oferta: content (HTML), json ou redirect |
name |
string | Não | Filtrar por nome da oferta (correspondência parcial) |
Retorna: objeto JSON com offers (lista de objetos incluindo id, name, type, content, modifiedAt) e total.
Prompt de exemplo: “Listar todas as ofertas JSON”.
Ferramenta: get_target_offer
Obtenha informações detalhadas sobre uma oferta específica.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
offer_id |
número inteiro | Sim | O identificador exclusivo da oferta |
Retorna: Detalhes completos da oferta, incluindo id, name, type, content, workspace e modifiedAt.
Exemplo de prompt: “Obter detalhes da oferta 67890”.
Ferramentas de público tools-audiences
Ferramenta: list_target_audiences
Liste todos os públicos do seu locatário do Target.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
limit |
número inteiro | Não | Número máximo de públicos-alvo a serem retornados |
offset |
número inteiro | Não | Número de públicos-alvo a serem ignorados para paginação |
Retorna: objeto JSON com audiences (lista de objetos incluindo id, name, description, origin, modifiedAt) e total.
Exemplo de prompt: “Listar todos os públicos-alvo”.
Ferramenta: get_target_audience
Obtenha detalhes do público-alvo, incluindo regras de direcionamento.
Recupera a configuração completa de um público-alvo específico, incluindo suas regras de direcionamento e condições.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
audience_id |
número inteiro | Sim | O identificador exclusivo do público-alvo |
Retorna: detalhes completos sobre o público-alvo, incluindo id, name, description, origin, regras de direcionamento e contagem de atividades associada.
Prompt de exemplo: “Obter detalhes do público-alvo 12345 e mostrar suas regras de direcionamento para mim.”
Ferramentas da mbox tools-mboxes
Ferramenta: list_target_mboxes
Liste todas as mboxes em seu locatário do Target.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
limit |
número inteiro | Não | Número máximo de mboxes a serem retornadas |
offset |
número inteiro | Não | Número de mboxes a serem ignoradas para paginação |
name |
string | Não | Filtrar por nome de mbox (correspondência parcial) |
status |
string | Não | Filtrar por status |
Retorna: objeto JSON com mboxes (lista de objetos incluindo name, status, lastRequestTime) e total.
Exemplo de prompt: “Listar todas as mboxes contendo ‘homepage’.”
Ferramenta: get_target_mbox
Obtenha informações detalhadas sobre uma mbox específica.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
mbox_name |
string | Sim | O nome da mbox |
Retorna: detalhes da mbox, incluindo name, status e lista de atividades usando a mbox.
Prompt de exemplo: “Obter detalhes da mbox ‘homepage-hero’.”
Ferramenta: list_target_mbox_profile_attributes
Liste todos os atributos de perfil de mbox disponíveis para direcionamento.
Nenhum parâmetro é necessário.
Retorna: matriz JSON de objetos de atributo de perfil.
Exemplo de prompt: “Quais atributos de perfil estão disponíveis para direcionamento?”
Ferramentas de propriedade tools-properties
Ferramenta: list_target_properties
Liste todas as propriedades em seu locatário do Target.
As propriedades organizam atividades e controlam o acesso.
Nenhum parâmetro é necessário.
Retorna: Lista de objetos de propriedade incluindo id, name, description e channel.
Prompt de exemplo: “Listar todas as propriedades do Target”.
Ferramentas de relatórios tools-reporting
Ferramenta: get_ab_performance_report
Obtenha um relatório de desempenho para uma atividade A/B.
Recupera taxas de conversão, aumentos e níveis de confiança.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade A/B |
report_interval |
string | Não | Período do relatório (por exemplo, last7days, last30days ou um intervalo de datas personalizado) |
Retorna: métricas de nível de experiência (visitantes, conversões, taxa de conversão), cálculos de aumento, níveis de confiança estatística e métricas de receita (se configuradas).
Prompt de exemplo: “Mostrar o relatório de desempenho do teste A/B 12345 dos últimos 30 dias.”
Ferramenta: get_ab_orders_report
Obtenha um relatório de pedidos/receita para uma atividade A/B.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade A/B |
report_interval |
string | Não | Período do relatório |
Devoluções: Contagens de pedidos, receita e valor médio de pedidos por experiência.
Exemplo de prompt: “Obter o relatório de pedidos para a atividade 12345”.
Ferramenta: get_xt_performance_report
Obtenha um relatório de desempenho para uma atividade de Direcionamento de experiência.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade de XT |
report_interval |
string | Não | Período do relatório |
Retorna: métricas de desempenho de nível de experiência.
Prompt de exemplo: “Mostrar desempenho para minha atividade de Direcionamento de Experiência 54321”.
Ferramenta: get_xt_orders_report
Obtenha um relatório de pedidos/receita para uma atividade de Direcionamento de experiência.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade de XT |
report_interval |
string | Não | Período do relatório |
Retorna: Ordenar métricas por experiência.
Exemplo de prompt: “Obter dados de pedidos para a atividade XT 54321”.
Ferramenta: get_activity_report_by_name
Procure uma atividade por nome e obtenha o relatório de desempenho.
Útil quando você sabe o nome da atividade, mas não a ID.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_name |
string | Sim | Nome da atividade a ser pesquisada |
report_interval |
string | Não | Período do relatório |
Retorna: detalhes da atividade e métricas de desempenho.
Prompt de exemplo: “Obter o relatório de desempenho da minha atividade ‘Teste de Herói da Página Inicial’.”
Ferramenta: get_a4t_report
Buscar um relatório do Analytics for Target (A4T) para uma atividade Target.
Valida a configuração A4T da atividade e executa consultas GraphQL em Adobe Analytics para recuperar métricas do lado do Analytics. Disponível somente para atividades com relatórios do A4T configurados.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade Target |
report_interval |
string | Não | Período do relatório (por exemplo, last7days, last30days ou um intervalo de datas personalizado) |
Retorna: métricas do lado analítico da atividade, incluindo contagens de visitantes, conversões, receita e aumento por experiência, originadas diretamente de Adobe Analytics.
Prompt de exemplo: “Puxe o relatório do A4T para meu teste de otimização de check-out e resuma os dados de conversão do lado do Analytics.”
Ferramentas de visualização tools-preview
Ferramenta: preview_activity
Gerar URLs de visualização de QA do navegador para uma atividade Target.
Cria links de visualização clicáveis que forçam a exibição de experiências específicas, ignorando as regras de direcionamento de público-alvo. Funciona para atividades A/B, XT e Automated Personalization.
| table 0-row-4 1-row-4 2-row-4 3-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | A ID da atividade Target para visualizar |
experience_index |
número inteiro | Não | Índice de experiência com base em 0. Se omitido, retorna URLs para todas as experiências |
url |
string | Não | URL da página para visualização. Obrigatório para atividades baseadas em formulário. Para atividades do VEC, substitui o local criado, se fornecido |
Retorna: informações de atividade (nome, tipo, estado), URLs de visualização para cada experiência, além de nomes e índices de experiência.
Prompt de exemplo: “Gerar URLs de visualização para a atividade 12345 para que eu possa testar cada experiência no meu navegador.”
Ferramentas de token de resposta tools-response-tokens
Ferramenta: list_target_response_tokens
Liste todos os tokens de resposta em seu locatário do Target.
Recupera todos os tokens de resposta configurados, incorporados e personalizados.
Nenhum parâmetro é necessário.
Retorna: matriz JSON de objetos de token de resposta com status name, type e enabled.
Exemplo de prompt: “Listar todos os tokens de resposta”.
Ferramentas de revisão tools-revisions
Ferramenta: get_target_revisions
Obter o log de auditoria para um tipo de recurso.
Recupera alterações feitas em Target recursos com filtragem opcional por autor.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
revision_resource_type |
string | Sim | Tipo de recurso: activity, offer ou audience |
modified_by |
string | Não | Filtrar por usuário que fez alterações |
limit |
número inteiro | Não | Número máximo de revisões retornadas |
offset |
número inteiro | Não | Número de revisões a serem ignoradas para paginação |
Retorna: histórico de revisões com carimbos de data/hora, usuários e descrições de alterações.
Prompt de exemplo: “Mostrar o log de auditoria para alterações de atividades”.
Ferramenta: get_target_entity_revisions
Obtenha todas as revisões de uma entidade específica por ID.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
revision_resource_type |
string | Sim | Tipo de recurso: activity, offer ou audience |
entity_id |
número inteiro | Sim | O identificador exclusivo da entidade |
Retorna: a matriz JSON de todas as revisões da entidade especificada.
Prompt de exemplo: “Mostrar todas as alterações feitas na atividade 12345.”
Ferramentas de modelo tools-templates
Ferramenta: list_target_templates
Liste os recursos e modelos do MCP disponíveis para criar atividades e ofertas.
Nenhum parâmetro é necessário.
Retorna: o objeto JSON está listando os modelos e recursos disponíveis.
Exemplo de prompt: “Quais modelos estão disponíveis para criar atividades?”
Resumo das ferramentas tools-summary
list_target_activities, get_ab_activity, get_xt_activity, get_abt_activitylist_target_offers, get_target_offerlist_target_audiences, get_target_audiencelist_target_mboxes, get_target_mbox, list_target_mbox_profile_attributeslist_target_propertiesget_ab_performance_report, get_ab_orders_report, get_xt_performance_report, get_xt_orders_report, get_activity_report_by_name, get_a4t_reportpreview_activitylist_target_response_tokensget_target_revisions, get_target_entity_revisionslist_target_templates