Agente de detección de campos

Al crear audiencias o incorporar datos en Adobe Experience Platform, la identificación del campo XDM correcto para un concepto empresarial suele requerir la exploración manual de esquemas o saber de antemano exactamente cómo se denomina un campo. Los distintos campos pueden representar el mismo concepto con nombres diferentes (por ejemplo, estado, región y ubicación) y elegir el incorrecto introduce errores en los flujos de trabajo descendentes.

El agente de detección de campos es un agente con tecnología de IA en Adobe Experience Platform que le ayuda a encontrar, evaluar y seleccionar campos XDM mediante consultas en lenguaje natural en el asistente de IA. Describe lo que busca en lenguaje sencillo: un concepto empresarial, un objetivo de flujo de trabajo o un nombre de campo específico, y el agente devuelve sugerencias de campos clasificados con contexto de soporte.

El agente de detección de campos se invoca automáticamente en segundo plano en el asistente de IA cuando otros agentes de Experience Platform necesitan resolver referencias de campos o entidades. En estos casos, funciona en segundo plano para mejorar la precisión del agente con el que está trabajando. Cuando necesite la detección de campos para su propio trabajo, escriba un mensaje explícito de búsqueda de campos en el Asistente de IA. El agente de detección de campos solo muestra información de campo. No modifica esquemas, conjuntos de datos ni audiencias y respeta los controles de acceso y el contexto de la zona protegida existentes.

Cuándo usar esto when-to-use-this

Utilice Field Discovery Agent explícitamente en el asistente de IA cuando necesite sugerencias de campos clasificados, valores de muestra y contexto de uso para una asignación, segmentación o consulta. Se utiliza implícitamente cuando otro agente de Experience Platform lo invoca en segundo plano para resolver referencias de campos o entidades. En estos casos, permanecerá en el flujo de trabajo de ese agente y no emitirá un mensaje de búsqueda de campos independiente.

Requisitos previos prerequisites

Para utilizar el agente de detección de campos, asegúrese de que dispone de lo siguiente:

La familiaridad básica con los esquemas XDM y cómo se utilizan los campos en la segmentación o en los flujos de trabajo de datos puede ayudarle a interpretar los resultados de forma más eficaz. Para obtener más información, consulte la descripción general de XDM y la documentación del Editor de esquemas.

Para obtener instrucciones sobre cómo habilitar el acceso al Asistente de IA y conceder los permisos necesarios, consulte la guía de acceso de Agent Orchestrator.

Funciones del agente de detección de campos field-discovery-agent-functions

El agente de detección de campos procesa la consulta y devuelve uno de los tres tipos de salida según la intención. Estas funciones reflejan cómo el agente interpreta la consulta; no las selecciona. El agente determina automáticamente el tipo de respuesta adecuado en función de lo que describa.

Cómo funciona el agente de detección de campos how-field-discovery-agent-works

En un nivel superior, el agente interpreta su intención, busca los datos disponibles y clasifica los resultados por relevancia. La forma en que expresa la consulta afecta directamente a cada fase, lo que a su vez afecta a la calidad de los resultados.

Al enviar una consulta en el Asistente de IA, el agente de detección de campos procesa la solicitud en tres fases:

Comprender los resultados understand-your-results

Field Discovery Agent devuelve un conjunto de resultados estructurado para cada consulta. Comprender los componentes de un resultado le ayuda a evaluar los campos candidatos y actuar en consecuencia con confianza, sin pruebas ni errores adicionales.

Trate un campo como listo para usarlo cuando su etiqueta Relevancia sea Muy relevante, sus valores de muestra coincidan con los datos que espera (cuando estén disponibles) y sus Contextos de uso se alineen con la forma en que planea usarlo. Si los resultados son solo Relevantes moderadamente o Relevantes, los valores de muestra no coinciden con las expectativas o el contexto de uso es limitado, refina la consulta y revisa un nuevo conjunto de resultados antes de continuar.

Etiquetas de relevancia

El agente de detección de campos asigna una etiqueta de relevancia en la columna Relevancia del panel Campos identificados para cada resultado de campo, lo que indica la proximidad del campo a la consulta.

Si todos los resultados están etiquetados como Moderadamente relevante o Relevante en lugar de Altamente relevante, es posible que la consulta sea demasiado amplia o que utilice una terminología que no coincida con los metadatos del esquema. Refine la solicitud con términos de dominio o idioma más específicos que reflejen el nombre de los campos.

Valores de muestra

Junto a cada sugerencia de campo, el agente de detección de campos muestra valores de muestra extraídos de los datos del campo en la zona protegida. Los valores de muestra ayudan a comprobar que un campo contiene el tipo de datos esperado antes de seleccionarlo.

Los valores de muestra solo son visibles para los campos dentro de los permisos de acceso del conjunto de datos. Para obtener información sobre el control de datos y las restricciones de uso en Experience Platform, consulte la Información general sobre el control de datos.

Si no aparecen valores de muestra para un campo, es posible que el campo esté vacío en la zona protegida actual o que los permisos no incluyan el acceso a su conjunto de datos subyacente. Los campos con alta cardinalidad (como los campos de identificador o UUID) también pueden no devolver valores de muestra representativos. Los valores de muestra se agregan y se basan en la frecuencia y no se pueden rastrear en perfiles individuales.

Contexto de uso

Cada resultado de campo incluye un contexto de uso que muestra dónde aparece el campo en el ecosistema de datos:

Conjunto de datos de Audience → → Esquema de → de destino

Un campo que se utiliza en una audiencia publicada, aparece en un conjunto de datos activo, está asignado a un destino activo y se define en un esquema que ha demostrado un uso real en su entorno. Esto distingue los campos en los que se confía activamente de los campos que existen solo en una definición de esquema, pero que no se han utilizado en la práctica. Utilice esta señal junto con la etiqueta de relevancia y los valores de muestra para realizar una selección de campo más informada.

Resultados en el asistente de IA

El agente de detección de campos devuelve resultados en un panel de Campos identificados dentro de la respuesta del asistente de IA. El panel muestra una tabla con tres columnas:

Aparece una sección Resultados explicados debajo de la tabla Campos identificados y proporciona contexto de nivel de campo adicional, incluidas explicaciones y detalles de compatibilidad para cada resultado. Para obtener instrucciones sobre cómo navegar por la interfaz del Asistente de IA, consulte la guía de la interfaz de usuario del Asistente de IA.

Usar agente de detección de campos use-field-discovery-agent

Interactúa con el agente de detección de campos a través del asistente de IA mediante lenguaje natural. El agente requiere una declaración de intención clara: una consulta vaga o excesivamente breve produce resultados de baja calidad o puede que no invoque el agente de detección de campos en absoluto.

Para la detección explícita de campos, siga este flujo de trabajo: identifique el atributo o el problema de asignación, envíe una consulta de búsqueda de campos, revise los resultados de clasificación y el contexto de uso en el panel Campos identificados, seleccione la ruta de Nombre de campo que se ajuste a sus intenciones y aplique esa ruta XDM en el Generador de segmentos, el Servicio de consulta u otro flujo de trabajo.

Para utilizar el agente de detección de campos:

Si es necesario, seleccione el menú desplegable Razonamiento completado sobre la respuesta para confirmar que el agente de detección de campos gestionó su solicitud. La lista desplegable muestra detalles del razonamiento que indican a qué agente se llamó.

Para obtener instrucciones sobre la interfaz del Asistente de IA, consulte la guía de la interfaz de usuario del Asistente de IA.

Casos de uso admitidos supported-use-cases

Las secciones siguientes describen cada una de las tres funciones del agente de detección de campos con escenarios representativos y mensajes de ejemplo. Los resultados incluyen etiquetas de relevancia y contexto de uso para ayudar a evaluar los campos. Para la interpretación de resultados, vea Comprender sus resultados. El agente de detección de campos devuelve únicamente información de campo; no crea audiencias, ejecuta consultas ni inserta datos en otras herramientas. Después de identificar un campo, lea su ruta XDM de la columna Nombre de campo y utilícela en el flujo de trabajo descendente.

Identificar campos para un concepto empresarial

Al describir un concepto o atributo de datos específico, el agente de detección de campos devuelve una lista clasificada de campos que coinciden semánticamente con la descripción.

“¿Qué campos representan el estado o la provincia de origen de un cliente?”
“Buscar campos relacionados con la fecha de transacción de compra.”
“¿Qué campos contienen información sobre el consentimiento de marketing por correo electrónico?”

La respuesta enumera los campos candidatos con su etiqueta de relevancia y ruta XDM en el panel Campos identificados. Los campos etiquetados como Muy relevante se asemejan más a su concepto indicado. Si los resultados principales están etiquetados como Moderadamente relevante o Relevante en lugar de Altamente relevante, refina la consulta usando una terminología más específica o un contexto de nivel de campo.

Obtener recomendaciones de campo para un caso de uso

Cuando describe un objetivo de flujo de trabajo o un caso de uso, como crear un segmento, incorporar un conjunto de datos o preparar una consulta, Field Discovery Agent recomienda campos alineados con ese objetivo, priorizados por la relevancia.

“Quiero crear una audiencia de clientes de alto valor. ¿Qué campos debo utilizar?”
“Campos recomendados para modelar la tendencia a la compra”.
“¿Qué campos debo incluir al incorporar un conjunto de datos de transacciones minoristas?”

La respuesta devuelve una lista priorizada de campos con contexto de relevancia. Revise el contexto de uso de cada campo recomendado para confirmar que se utiliza activamente en su entorno.

Enriquecimiento del contexto de campo

Cuando se pregunta por un campo específico por su nombre o ruta, el agente de detección de campos devuelve un contexto detallado para ese campo, incluidos valores de muestra, ubicación de esquema y uso en conjuntos de datos, audiencias y destinos.

“Más información acerca del campo person.name.lastName”.
“¿Qué valores de muestra existen para homeAddress.stateProvince?”
“¿Dónde se utiliza el campo commerce.purchases.value en mis conjuntos de datos y audiencias?”

La respuesta devuelve los valores de muestra del campo, la ubicación del esquema, los conjuntos de datos asociados y cualquier audiencia o destino en el que aparezca el campo. Revise este contexto para confirmar que el campo contiene los datos esperados.

Dentro y fuera de ámbito in-scope-and-out-of-scope

Esta sección resume lo que puede y no puede hacer el agente de detección de campos. Para obtener instrucciones detalladas sobre la tarea, consulte Casos de uso admitidos. Para ver las restricciones de la plataforma, consulte Protecciones y limitaciones.

En ámbito

En la siguiente lista se describen las tareas que puede realizar el agente de detección de campos; utilícelo para confirmar si el agente puede satisfacer su solicitud antes de depender de ella en el flujo de trabajo.

Fuera de ámbito

La siguiente lista describe las acciones que el agente de detección de campos no realiza; utilícelo para evitar depender del agente para trabajar fuera de su ámbito.

Mecanismos de protección y limitaciones guardrails-and-limitations

Estas protecciones son importantes porque el agente de detección de campos funciona dentro de restricciones de nivel de plataforma que afectan a la disponibilidad y calidad de los resultados. Utilícelos para interpretar los resultados que faltan, los que se retrasan o los que están incompletos, y para solucionar los huecos inesperados con expectativas realistas.

Base de conocimiento

Field Discovery Agent se basa en una base de conocimiento que se actualiza periódicamente con esquemas y metadatos de su entorno de Experience Platform. Los resultados reflejan el estado de la base de conocimiento en el momento de la consulta, no el estado en tiempo real de los esquemas, y puede haber un retraso entre la ingesta de datos y el momento en que aparece en el agente.

Es posible que los nuevos esquemas, campos o conjuntos de datos agregados al entorno no aparezcan inmediatamente en los resultados de Field Discovery Agent. Los resultados pueden tardar un tiempo en reflejar los cambios recientes.

Calidad y cobertura de metadatos

La calidad de los resultados depende de la calidad y la integridad de los metadatos de los campos en el entorno de Experience Platform. El agente utiliza nombres de campo, nombres para mostrar, descripciones y asociaciones de uso para clasificar los resultados. Es posible que los campos con metadatos deficientes o que falten no aparezcan en los resultados o que se clasifiquen por debajo de lo esperado.

Si tiene acceso a la edición de esquemas, puede mejorar la calidad de los resultados mediante lo siguiente:

Para obtener instrucciones sobre cómo editar nombres para mostrar y descripciones de campos en el Editor de esquemas, consulte Crear y editar esquemas en la interfaz de usuario.

Si no tiene acceso a la edición de esquemas y los resultados son deficientes de forma consistente, póngase en contacto con el administrador de Experience Platform o con el equipo de ingeniería de datos para revisar los metadatos de los campos de los esquemas con los que trabaja.

Restricciones de acceso y PII

Field Discovery Agent respeta todos los controles de acceso de Experience Platform existentes y funciona dentro del contexto de la zona protegida actual. Solo se reciben resultados para campos de esquemas y conjuntos de datos a los que está autorizado a acceder.

Los valores de muestra están regidos por los mismos permisos de nivel de conjunto de datos. Los campos de conjuntos de datos con perfil habilitado con restricciones PII devuelven valores de muestra solo si tiene el acceso requerido. Consulte Valores de muestra para obtener instrucciones de administración. El agente de detección de campos no omite la seguridad de nivel de campo ni las restricciones de acceso habilitadas para perfiles.

Prácticas recomendadas best-practices

Siga estas directrices para obtener resultados precisos y procesables de Field Discovery Agent.

Ejemplos de peticiones example-prompts

Utilice esta sección como biblioteca de mensajes de referencia rápida. Si no tiene experiencia previa con Field Discovery Agent, lea primero Prácticas recomendadas y Casos de uso admitidos para saber cuándo y por qué se aplica cada función.

Indicadores de identificación

Utilice estas indicaciones cuando conozca el concepto de datos que necesita, pero no el campo que lo contiene.

“¿Qué campo contiene el estado o la región de un cliente?”
“Buscar campos relacionados con el estado de suscripción de correo electrónico”.
“¿Qué campo contiene la fecha de la primera compra de un cliente?”
“Identifique campos que representen el valor de duración del cliente”.
“¿Qué campos de mi esquema de perfil se relacionan con la pertenencia al programa de fidelidad?”

Mensajes de recomendación

Utilice estas indicaciones cuando inicie un flujo de trabajo y necesite instrucciones sobre los campos que desea incluir para un objetivo específico.

“¿Qué campos debo utilizar para crear una audiencia de renovación de la participación?”
“Campos recomendados para una audiencia dirigida a clientes que no han realizado compras en 90 días”.
“¿Qué campos son más útiles para modelar el riesgo de pérdida?”
“Sugerir campos que debería incluir al crear una segmentación geográfica”.
“Estoy construyendo un modelo de tendencia a comprar. ¿Con qué campos debo empezar?”

Mensajes de enriquecimiento

Utilice estos indicadores cuando tenga un campo candidato y desee verificarlo antes de utilizarlo en un segmento, consulta o asignación.

“Más información sobre homeAddress.stateProvince”.
“Mostrarme valores de muestra para commerce.purchases.value.”
“¿Dónde se usa person.name.lastName en mis conjuntos de datos y audiencias?”
“¿Qué conjuntos de datos contienen el campo web.webPageDetails.URL?”
“¿Está segmentMembership asignado a algún destino activo?”

Solución de problemas troubleshooting

Utilice esta sección cuando falten resultados, cuando no estén esperados o cuando no esté seguro de si el agente de detección de campos ha gestionado su solicitud.

Para comprobar qué agente gestionó su solicitud, consulte el paso 6 de Usar el agente de detección de campos.