Agente de descoberta de campo

Ao criar públicos-alvo ou integrar dados no Adobe Experience Platform, a identificação do campo XDM correto para um conceito de negócios geralmente requer a navegação manual em esquemas ou o conhecimento prévio de exatamente como um campo é nomeado. Campos diferentes podem representar o mesmo conceito com nomes diferentes, por exemplo, estado, região e local, e escolher o errado introduz erros em workflows downstream.

O Agente de descoberta de campo é um agente habilitado por IA na Adobe Experience Platform que ajuda a localizar, avaliar e selecionar campos XDM usando consultas de linguagem natural no Assistente de IA. Você descreve o que está procurando em linguagem simples (um conceito comercial, uma meta de fluxo de trabalho ou um nome de campo específico), e o agente retorna sugestões de campos classificados com contexto de suporte.

O Field Discovery Agent é chamado automaticamente em segundo plano no Assistente do AI quando outros agentes do Experience Platform precisam resolver referências de campo ou de entidade. Nesses casos, ele opera em segundo plano para melhorar a precisão do agente com o qual você está trabalhando. Quando precisar de uma descoberta de campo para seu próprio trabalho, escreva um prompt de descoberta de campo explícito no Assistente do AI. O Agente de Descoberta de Campo só exibe informações de campo. Ele não modifica esquemas, conjuntos de dados ou públicos-alvo e respeita os controles de acesso e o contexto da sandbox existentes.

Quando usar isto when-to-use-this

Use o Agente de descoberta de campo explicitamente no Assistente de IA quando precisar de sugestões de campos classificados, valores de exemplo e contexto de uso para um mapeamento, segmentação ou consulta. Ele é usado implicitamente quando outro agente do Experience Platform o chama em segundo plano para resolver referências de campo ou de entidade. Nesses casos, você permanece no fluxo de trabalho desse agente e não emite um prompt de descoberta de campo separado.

Pré-requisitos prerequisites

Para usar o Field Discovery Agent, verifique se você tem o seguinte:

A familiaridade básica com esquemas XDM e como os campos são usados na segmentação ou em workflows de dados pode ajudar você a interpretar resultados com mais eficiência. Para obter mais informações, consulte a visão geral do XDM e a documentação do Editor de esquemas.

Para obter instruções sobre como habilitar o acesso ao Assistente de IA e conceder as permissões necessárias, consulte o guia de acesso do Agent Orchestrator.

Funções do agente de detecção de campo field-discovery-agent-functions

O Field Discovery Agent processa sua consulta e retorna um dos três tipos de saída, dependendo de sua intenção. Essas funções refletem como o agente interpreta sua consulta; você não as seleciona. O agente determina automaticamente o tipo de resposta apropriado com base no que você descreve.

Como o Field Discovery Agent funciona how-field-discovery-agent-works

Em um alto nível, o agente interpreta sua intenção, pesquisa seus dados disponíveis e classifica os resultados por relevância. A forma como o query é formulado afeta diretamente cada estágio, o que, por sua vez, afeta a qualidade dos resultados.

Quando você envia uma consulta no Assistente de IA, o Agente de descoberta de campo processa sua solicitação em três estágios:

Entender os resultados understand-your-results

O Field Discovery Agent retorna um conjunto de resultados estruturado para cada consulta. Compreender os componentes de um resultado ajuda a avaliar campos candidatos e agir com eles com confiança, sem tentativa e erro adicionais.

Trate um campo como pronto para uso quando seu rótulo Relevância for Altamente Relevante, seus valores de exemplo corresponderem aos dados esperados (quando disponíveis), e seus Contextos de Uso estiverem alinhados com a maneira como você planeja usá-lo. Se os resultados forem apenas Moderadamente Relevantes ou Relevantes, os valores de exemplo não corresponderão às suas expectativas ou o contexto de uso será limitado, refine sua consulta e revise um novo conjunto de resultados antes de continuar.

Rótulos de relevância

O Agente de Descoberta de Campos atribui um rótulo de relevância na coluna Relevância do painel Campos Identificados para cada resultado de campo, indicando a proximidade com que o campo corresponde à sua consulta.

Se todos os resultados forem rotulados como Moderadamente Relevante ou Relevante em vez de Altamente Relevante, sua consulta poderá ser muito ampla ou usar terminologia que não corresponda aos seus metadados de esquema. Refine seu prompt com termos mais específicos de idioma ou domínio que refletem como os campos são nomeados.

Valores de amostra

Juntamente com cada sugestão de campo, o Field Discovery Agent supera valores de amostra obtidos dos dados do campo na sandbox. Os valores de amostra ajudam a verificar se um campo contém o tipo de dados esperado antes de selecioná-lo.

Os valores de amostra são visíveis somente para campos nas permissões de acesso do conjunto de dados. Para obter informações sobre governança de dados e restrições de uso no Experience Platform, consulte a visão geral sobre governança de dados.

Se nenhum valor de amostra for exibido para um campo, ele poderá estar vazio na sandbox atual ou as permissões talvez não incluam acesso ao conjunto de dados subjacente. Campos com alta cardinalidade (como campos de identificador ou UUID) também podem não retornar valores de amostra representativos. Os valores de amostra são agregados e baseados em frequência e não são rastreáveis a perfis individuais.

Contexto de uso

Cada resultado de campo inclui um contexto de uso que mostra onde o campo aparece em seu ecossistema de dados:

Público-Alvo → Conjunto De Dados → Destino → Esquema

Um campo usado em um público publicado, exibido em um conjunto de dados ativo, mapeado para um destino em tempo real e definido em um esquema demonstrou o uso real em seu ambiente. Isso distingue campos que são ativamente dependentes de campos que existem apenas em uma definição de esquema, mas que não foram usados na prática. Use esse sinal junto com o rótulo de relevância e valores de amostra para fazer uma seleção de campo mais informada.

Resultados no Assistente de IA

O Agente de Descoberta de Campo retorna resultados em um painel Campos Identificados na resposta do Assistente de IA. O painel exibe uma tabela com três colunas:

Uma seção Resultados Explicados aparece abaixo da tabela Campos Identificados e fornece contexto de campo adicional, incluindo explicações e detalhes de suporte para cada resultado. Para obter orientação sobre como navegar na interface do Assistente de IA, consulte o Guia da interface do Assistente de IA.

Usar agente de descoberta de campo use-field-discovery-agent

Você interage com o Field Discovery Agent por meio do Assistente de IA usando linguagem natural. O agente requer uma declaração clara de intenção — uma consulta vaga ou muito breve produz resultados de qualidade inferior ou não pode invocar o Field Discovery Agent.

Para a descoberta de campo explícito, siga este fluxo de trabalho: identifique o problema de atributo ou mapeamento, envie uma consulta de descoberta de campo, revise os resultados classificados e o contexto de uso no painel Campos Identificados, selecione o caminho Nome do Campo que se ajuste à sua intenção e aplique esse caminho XDM no Construtor de Segmentos, no Serviço de Consulta ou em outro fluxo de trabalho.

Para usar o Field Discovery Agent:

Se necessário, selecione a lista suspensa Raciocínio concluído acima da resposta para confirmar se o Agente de Descoberta de Campo tratou sua solicitação. A lista suspensa exibe detalhes de raciocínio que indicam qual agente foi chamado.

Para obter orientação sobre a interface do Assistente de IA, consulte o Guia da interface do Assistente de IA.

Casos de uso aceitos supported-use-cases

As seções a seguir descrevem cada uma das três funções do Field Discovery Agent com cenários representativos e prompts de exemplo. Os resultados incluem rótulos de relevância e contexto de uso para ajudar a avaliar campos. Para interpretação dos resultados, consulte Entender seus resultados. O Field Discovery Agent retorna somente informações de campo — não cria públicos-alvo, executa consultas ou envia dados para outras ferramentas. Após identificar um campo, leia seu caminho XDM na coluna Nome do Campo e use-o no fluxo de trabalho downstream.

Identificar campos para um conceito de negócios

Quando você descreve um conceito ou atributo de dados específico, o Field Discovery Agent retorna uma lista classificada de campos que semanticamente correspondem à sua descrição.

“Quais campos representam o estado ou província residencial de um cliente?”
“Localizar campos relacionados à data da transação de compra.”
“Quais campos contêm informações sobre consentimento de marketing por email?”

A resposta lista os campos candidatos com seu rótulo de relevância e caminho XDM no painel Campos Identificados. Os campos rotulados como Altamente Relevantes correspondem mais ao conceito declarado. Se os principais resultados estiverem rotulados como Moderadamente Relevante ou Relevante em vez de Altamente Relevante, refine sua consulta usando a terminologia mais específica ou o contexto de nível de campo.

Obter recomendações de campo para um caso de uso

Ao descrever uma meta de fluxo de trabalho ou caso de uso (como criar um segmento, integrar um conjunto de dados ou preparar um query), o Field Discovery Agent recomenda campos alinhados a esse objetivo, priorizados por relevância.

“Quero construir um público-alvo de clientes de alto valor. Quais campos devo usar?”
“Campos recomendados para modelagem da propensão à compra.”
“Quais campos devo incluir ao integrar um conjunto de dados de transações de varejo?”

A resposta retorna uma lista priorizada de campos com contexto de relevância. Revise o contexto de uso de cada campo recomendado para confirmar se ele é usado ativamente em seu ambiente.

Enriquecer contexto de campo

Quando você pergunta sobre um campo específico por nome ou caminho, o Agente de descoberta de campo retorna o contexto detalhado desse campo, incluindo valores de amostra, localização do esquema e uso em conjuntos de dados, públicos e destinos.

“Conte-me mais sobre o campo person.name.lastName.”
“Quais valores de exemplo existem para homeAddress.stateProvince?”
“Onde o campo commerce.purchases.value é usado em meus conjuntos de dados e públicos?”

A resposta retorna os valores de amostra do campo, o local do esquema, os conjuntos de dados associados e quaisquer públicos ou destinos em que o campo aparece. Revise este contexto para confirmar se o campo contém os dados esperados.

Dentro e fora do escopo in-scope-and-out-of-scope

Esta seção resume o que o Field Discovery Agent pode ou não fazer. Para obter orientações detalhadas sobre tarefas, consulte Casos de uso com suporte. Para restrições de plataforma, consulte Medidas de proteção e limitações.

No escopo

A lista a seguir descreve as tarefas que o Agente de descoberta de campo pode executar; use-a para confirmar se o agente pode atender à sua solicitação antes de confiar nela no fluxo de trabalho.

Fora do escopo

A lista a seguir descreve as ações que o Field Discovery Agent não executa; use-as para evitar depender do agente para trabalhar fora de seu escopo.

Medidas de proteção e limitações guardrails-and-limitations

Essas medidas de proteção são importantes porque o Field Discovery Agent opera dentro de restrições no nível da plataforma que afetam a disponibilidade e a qualidade do resultado. Use-os para interpretar resultados ausentes, atrasados ou incompletos e para solucionar falhas inesperadas com expectativas realistas.

Knowledge base

O Field Discovery Agent depende de uma base de conhecimento atualizada periodicamente com esquema e metadados de seu ambiente Experience Platform. Os resultados refletem o estado da base de conhecimento no momento da consulta, não o estado em tempo real dos esquemas, e pode haver um atraso entre a assimilação de dados e quando ela é exibida no agente.

Novos esquemas, campos ou conjuntos de dados adicionados ao seu ambiente podem não aparecer nos resultados do Agente de descoberta de campo imediatamente. Os resultados podem levar tempo para refletir as alterações recentes.

Qualidade e cobertura dos metadados

A qualidade do resultado depende da qualidade e da integridade dos metadados de campo no ambiente do Experience Platform. O agente usa nomes de campo, nomes de exibição, descrições e associações de uso para classificar os resultados. Campos com metadados insuficientes ou ausentes podem não aparecer nos resultados ou podem ser classificados abaixo do esperado.

Se você tiver acesso para edição de esquemas, poderá melhorar a qualidade dos resultados ao:

Para obter orientação sobre como editar nomes para exibição de campo e descrições no Editor de Esquemas, consulte Criar e editar esquemas na interface.

Se você não tiver acesso para edição de esquemas e os resultados forem consistentemente ruins, entre em contato com o administrador do Experience Platform ou com a equipe de engenharia de dados para revisar os metadados de campo dos esquemas com os quais você trabalha.

Restrições de acesso e PII

O Field Discovery Agent respeita todos os controles de acesso existentes do Experience Platform e opera em seu contexto atual de sandbox. Você recebe resultados apenas para campos em esquemas e conjuntos de dados aos quais você está autorizado a acessar.

Os valores de amostra são regidos pelas mesmas permissões no nível do conjunto de dados. Os campos em conjuntos de dados habilitados para perfil com restrições de PII retornam valores de amostra somente se você tiver o acesso necessário. Consulte Valores de exemplo para obter orientação sobre como manusear. O Agente de descoberta de campo não ignora a segurança em nível de campo nem as restrições de acesso ativadas por perfil.

Práticas recomendadas best-practices

Use as orientações a seguir para obter resultados precisos e acionáveis do Field Discovery Agent.

Exemplo de prompts example-prompts

Use esta seção como uma biblioteca de prompts de referência rápida. Se você nunca usou o Field Discovery Agent, leia Práticas recomendadas e Casos de uso com suporte primeiro para entender quando e por que cada função se aplica.

Prompts de identificação

Use esses prompts quando você souber o conceito de dados necessário, mas não saber qual campo o contém.

“Qual campo contém o estado ou a região de um cliente?”
“Localizar campos relacionados ao status da assinatura de email.”
“Qual campo contém a data da primeira compra de um cliente?”
“Identificar campos que representam o valor vitalício do cliente.”
“Quais campos no meu esquema de perfil estão relacionados à associação ao programa de fidelidade?”

Prompts de recomendação

Use esses prompts quando estiver iniciando um workflow e precisar de orientação sobre quais campos incluir para uma meta específica.

“Quais campos devo usar para criar um público-alvo de reengajamento?”
“Campos recomendados para um público-alvo direcionado a clientes que não compraram em 90 dias.”
“Quais campos são mais úteis para modelagem de risco de churn?”
“Sugerir campos que devem ser incluídos ao criar uma segmentação geográfica.”
“Estou criando um modelo de propensão para comprar. Com quais campos devo começar?”

Prompts de enriquecimento

Use esses prompts quando tiver um campo candidato e quiser verificá-lo antes de usá-lo em um segmento, consulta ou mapeamento.

“Conte-me mais sobre homeAddress.stateProvince.”
“Mostrar valores de exemplo para commerce.purchases.value.”
“Onde o person.name.lastName é usado em meus conjuntos de dados e públicos?”
“Quais conjuntos de dados contêm o campo web.webPageDetails.URL?”
“O segmentMembership está mapeado para algum destino ativo?”

Solução de problemas troubleshooting

Use esta seção quando os resultados estiverem ausentes, inesperados ou quando você não tiver certeza se o Agente de Descoberta de Campo tratou sua solicitação.

Para verificar qual agente manipulou sua solicitação, consulte a etapa 6 em Usar o Agente de Descoberta de Campo.