Referência de ferramentas do servidor MCP Adobe Target target-mcp-tools-reference

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.

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_activity

Obtenha informações detalhadas sobre uma atividade de qualquer tipo.

Recupera a configuração completa de uma atividade específica, detectando automaticamente o tipo de atividade. Suporta atividades de Teste A/B, Direcionamento de experiência, Automated Personalization, Alocação automática, Teste multivariado e Recommendations.

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 12345”.

Ferramenta: create_ab_activity

Crie uma nova atividade de teste A/B.

Cria um novo teste A/B com a configuração especificada, incluindo experiências, ofertas e direcionamento.

Retorna: o objeto de atividade criado com sua ID atribuída.

Prompt de exemplo: “Crie um teste A/B chamado ‘Teste de Herói da Página Inicial’ com duas experiências testando imagens herói diferentes na mbox homepage-hero.”

Ferramenta: create_xt_activity

Crie uma nova atividade de Direcionamento de experiência (XT).

Cria uma atividade de XT que fornece experiências diferentes para públicos-alvo diferentes com base nas regras de direcionamento.

Retorna: o objeto de atividade criado com sua ID atribuída.

Prompt de exemplo: “Crie uma atividade de Direcionamento de Experiência chamada ‘Geo Personalization’ que mostre conteúdo diferente para visitantes de regiões diferentes.”

Ferramenta: update_activity

Atualize uma atividade existente de Teste A/B, Direcionamento de experiência ou Automated Personalization.

Usa um padrão de leitura-modificação-gravação: busca o estado atual, mescla as alterações, valida e envia a atualização. Oferece suporte a atividades de Teste A/B, Direcionamento de experiência e atividades do Automated Personalization; as atividades de Alocação automática, Teste multivariado e Recommendations são somente leitura. Os parâmetros goal, audience_ids e additional_metrics estruturados são suportados apenas para Teste A/B e Direcionamento de experiência; as atividades do Automated Personalization aceitam atualizações de mesclagem de campo simples.

Retorna: O objeto de atividade atualizado.

Prompt de exemplo: “Atualize a atividade 12345 para alterar a alocação de tráfego para 70/30.”

Ferramenta: update_activity_schedule

Atualize as datas de início e término da atividade.

Atualiza o agendamento de uma atividade sem modificar outras configurações.

Retorna: Confirmação da atualização da agenda.

Prompt de exemplo: “Atualize o agendamento da atividade A/B 12345 para execução de 1º de maio a 31 de maio”.

Ferramenta: update_activity_state

Alterar o estado da atividade (ativar, desativar ou pausar).

Retorna: O estado de atividade atualizado.

Prompt de exemplo: “Ativar atividade 12345” ou “Pausar o Teste Herói da Página Inicial”.

Ferramenta: update_activity_name

Renomeie uma atividade.

Atualiza somente o nome sem modificar a configuração completa.

Retorna: O objeto de atividade atualizado.

Prompt de exemplo: “Renomeie a atividade 12345 para ‘Teste de Herói da Campanha de Verão’.”

Ferramenta: update_activity_priority

Alterar prioridade da atividade.

Atividades de prioridade mais alta têm prioridade quando várias atividades têm como alvo o mesmo local.

Retorna: O objeto de atividade atualizado.

Prompt de exemplo: “Definir a prioridade da atividade 12345 para 100”.

Ferramenta: add_activity_variant

Adicionar uma nova experiência/variante a uma atividade.

Lida com toda a coordenação estrutural, incluindo a criação de opções, mapeamento para locais e reequilíbrio do tráfego.

Retorna: O objeto de atividade atualizado.

Prompt de exemplo: “Adicione uma nova variante chamada ‘Tema de Feriado’ à atividade A/B 12345 usando a oferta 67890.”

Ferramenta: update_traffic_split

Atualizar alocação de tráfego entre variantes.

As porcentagens devem somar exatamente 100.

Retorna: O objeto de atividade atualizado.

Prompt de exemplo: “Alterar a divisão de tráfego da atividade 12345 para 70% de Controle e 30% de Variante A”.

Ferramenta: update_variant_offer

Alterar a oferta de uma variante específica.

Funciona para atividades baseadas em formulário (usando offer_id) e atividades de VEC (usando modifications).

Retorna: O objeto de atividade atualizado.

Prompt de exemplo: “Atualize a experiência ‘Variante A’ na atividade 12345 para usar a oferta 99999.”

Ferramenta: remove_activity_variant

Remover uma experiência/variante de uma atividade.

Remove a experiência, limpa opções órfãs e redistribui o tráfego de maneira uniforme entre as variantes restantes.

Retorna: O objeto de atividade atualizado.

Prompt de exemplo: “Remover a experiência ‘Variante de Teste’ da atividade A/B 12345.”

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.

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.

Retorna: Detalhes completos da oferta, incluindo id, name, type, content, workspace e modifiedAt.

Exemplo de prompt: “Obter detalhes da oferta 67890”.

Ferramenta: create_target_offer

Crie uma nova oferta de conteúdo do HTML.

Retorna: a oferta criada com sua ID atribuída.

Exemplo de prompt: “Crie uma oferta do HTML chamada ‘Banner de Vendas de Verão’ com um banner promocional.”

Ferramenta: create_target_json_offer

Crie uma nova oferta JSON para fornecer dados estruturados.

Retorna: a oferta criada com sua ID atribuída.

Exemplo de prompt: “Crie uma oferta JSON chamada ‘Configuração de Sinalizadores de Recurso’ com configurações de alternância de recurso.”

Ferramenta: update_target_offer

Atualizar uma oferta existente.

Retorna: O objeto de oferta atualizado.

Prompt de exemplo: “Atualizar oferta 67890 com novo conteúdo promocional.”

Ferramenta: list_target_audiences

Liste todos os públicos do seu locatário do Target.

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.

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.”

Ferramenta: create_target_audience

Crie um novo público com regras de direcionamento.

Retorna: o público-alvo criado com sua ID atribuída.

Exemplo de prompt: “Crie um público chamado ‘Visitantes móveis da Califórnia’ direcionado a usuários móveis na CA.”

Ferramenta: list_target_mboxes

Liste todas as mboxes em seu locatário do Target.

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.

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?”

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”.

Ferramenta: get_activity_performance_report

Obtenha um relatório de desempenho para uma atividade de qualquer tipo.

Recupera taxas de conversão, aumentos e níveis de confiança. Suporta atividades de Teste A/B, Direcionamento de experiência, Automated Personalization, Alocação automática, Teste multivariado e Recommendations.

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 da atividade 12345 dos últimos 30 dias.”

Ferramenta: get_activity_orders_report

Obtenha um relatório de pedidos/receita para qualquer atividade.

Suporta atividades de Teste A/B, Direcionamento de experiência, Automated Personalization, Alocação automática, Teste multivariado e Recommendations.

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_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.

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.

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.”

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.

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.”

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”.

Ferramenta: create_target_response_token

Crie um novo token de resposta personalizado para coletar dados adicionais em Target respostas.

Retorna: o objeto de token de resposta criado.

Exemplo de prompt: “Criar um token de resposta personalizado chamado ‘campaign_id’ do tipo ACTIVITY.”

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.

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.

Retorna: a matriz JSON de todas as revisões da entidade especificada.

Prompt de exemplo: “Mostrar todas as alterações feitas na atividade 12345.”

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?”

Ferramentas: list_target_criteria, get_target_criteria, list_target_criteria_by_type, get_target_criteria_by_type, create_target_criteria, update_target_criteria

Critérios são regras que determinam quais itens recomendar, com base em um conjunto predeterminado de comportamentos do visitante. Os critérios estão agrupados em 9 famílias do tipo: category, custom, item, cart, popularity, profileattribute, recent, sequence, userhistory.

list_target_criteria e get_target_criteria retornam metadados mínimos de critérios entre famílias (id, name, criteriaTitle, criteriaGroup). Use list_target_criteria_by_type / get_target_criteria_by_type (ou create_target_criteria / update_target_criteria) com um criteria_type para trabalhar com a configuração completa específica de tipo. Os requisitos de campo são diferentes por família — consulte a Adobe Referência da API de Recomendações para obter o esquema por tipo completo.

Retorna: o objeto de critérios ou uma lista paginada com offset, limit, total e list.

Prompt de exemplo: “Lista todos os critérios do Recommendations configurados nesta conta e resume os tipos de algoritmo em uso.”

Ferramentas: list_target_collections, get_target_collection, create_target_collection, update_target_collection

As coleções agrupam entidades de catálogo por regras de correspondência, para uso em critérios e promoções.

Retorna: o objeto da coleção, incluindo id, name, description, rules e os metadados modificados por último.

Exemplo de prompt: “Quais coleções eu tenho e quais atributos de catálogo eles filtram?”

Ferramentas: list_target_designs, get_target_design, create_target_design, update_target_design

Designs são modelos do Velocity ou HTML que controlam como as entidades recomendadas são renderizadas.

Retorna: o objeto de design, incluindo id, name, script e type.

Prompt de exemplo: “Quais designs e coleções eu configurei para o Recommendations?”

Ferramentas: list_target_promotions, get_target_promotion, create_target_promotion, update_target_promotion

As promoções forçam entidades específicas a incluir os resultados da recomendação, tendo precedência sobre os critérios e as recomendações de backup.

Retorna: O objeto de promoção.

Prompt de exemplo: “Crie uma promoção externa que apresente a coleção ‘Backpacking Tents’ até o final de agosto.”

Ferramentas: list_target_exclusions, get_target_exclusion, create_target_exclusion, update_target_exclusion

As exclusões removem as entidades correspondentes dos resultados da recomendação. As exclusões se aplicam a toda a conta, em todos os critérios e atividades.

Retorna: O objeto de exclusão.

Exemplo de prompt: “Há alguma exclusão em toda a conta configurada no momento e com a qual ela é filtrada?”

Ferramentas: get_target_entity, search_target_catalog

Ferramentas somente leitura para inspecionar o catálogo de produtos/conteúdo do Recommendations. Não há ferramenta de criação, atualização ou exclusão para entidades de catálogo por meio do servidor MCP.

Retorna: get_target_entity retorna os atributos de catálogo da entidade. search_target_catalog retorna correspondências em uma matriz entities. Os nomes de campos em query devem ser atributos de catálogo reais configurados para o locatário.

Exemplo de prompt: “Pesquisar o catálogo de produtos com inventário abaixo de 1000.”