Agente di individuazione campi

Quando si creano tipi di pubblico o si creano dati di onboarding in Adobe Experience Platform, spesso per identificare il campo XDM corretto per un concetto aziendale è necessario sfogliare manualmente gli schemi o sapere in anticipo esattamente come viene denominato un campo. Campi diversi possono rappresentare lo stesso concetto con nomi diversi (ad esempio, stato, regione e posizione) e la scelta di quello sbagliato introduce errori nei flussi di lavoro a valle.

L’agente di individuazione campi è un agente basato sull’intelligenza artificiale in Adobe Experience Platform che consente di trovare, valutare e selezionare campi XDM utilizzando query in linguaggio naturale nell’Assistente all’intelligenza artificiale. Descrivi cosa stai cercando in un linguaggio semplice: un concetto di business, un obiettivo di flusso di lavoro o un nome di campo specifico; l’agente restituisce i suggerimenti di campi classificati con un contesto di supporto.

L’agente di individuazione campi viene richiamato automaticamente in background nell’Assistente IA quando altri agenti Experience Platform devono risolvere riferimenti a campi o entità. In questi casi, opera in background per migliorare la precisione dell’agente con cui stai lavorando. Quando hai bisogno dell’individuazione dei campi per il tuo lavoro, scrivi un esplicito prompt di ricerca dei campi in Assistente IA. L’agente di individuazione campi fa emergere solo le informazioni sui campi. Non modifica schemi, set di dati o tipi di pubblico e rispetta i controlli di accesso e il contesto sandbox esistenti.

Quando utilizzare questo when-to-use-this

Utilizza l’agente di individuazione campi in modo esplicito nell’Assistente AI quando sono necessari suggerimenti di campo con classificazione, valori di esempio e contesto di utilizzo per una mappatura, segmentazione o query. Viene utilizzato implicitamente quando un altro agente Experience Platform lo richiama in background per risolvere riferimenti a campi o entità. In questi casi, rimani nel flusso di lavoro di quell’agente e non invii un messaggio di ricerca campo separato.

Prerequisiti prerequisites

Per utilizzare l’agente di individuazione campi, verificare di disporre dei seguenti elementi:

Una conoscenza di base degli schemi XDM e del modo in cui i campi vengono utilizzati nella segmentazione o nei flussi di lavoro dei dati può aiutarti a interpretare i risultati in modo più efficace. Per ulteriori informazioni, vedere la panoramica XDM e la documentazione dell’editor di schemi.

Per istruzioni su come abilitare l’accesso all’Assistente AI e concedere le autorizzazioni necessarie, consulta la guida all’accesso di Agent Orchestrator.

Funzioni dell’agente di individuazione campi field-discovery-agent-functions

L’agente di individuazione campi elabora la query e restituisce uno dei tre tipi di output in base all’intento. Queste funzioni riflettono il modo in cui l’agente interpreta la query; non vengono selezionate. L’agente determina automaticamente il tipo di risposta appropriato in base a ciò che descrivi.

Funzionamento di Field Discovery Agent how-field-discovery-agent-works

Ad alto livello, l’agente interpreta l’intento, cerca i dati disponibili e classifica i risultati in base alla rilevanza. La modalità di formulazione della query influisce direttamente su ogni fase, il che a sua volta influisce sulla qualità dei risultati.

Quando si invia una query nell’Assistente all’analisi dei campi, l’agente di individuazione campi elabora la richiesta in tre fasi:

Comprendere i risultati understand-your-results

L’agente di individuazione campi restituisce un set di risultati strutturati per ogni query. Comprendere i componenti di un risultato consente di valutare i campi candidati e di agire in modo affidabile, senza ulteriori tentativi ed errori.

Considera un campo pronto all’uso quando la relativa etichetta Rilevanza è Altamente rilevante, i valori di esempio corrispondono ai dati previsti (se disponibili) e i relativi Contesti di utilizzo sono allineati con le modalità di utilizzo previste. Se i risultati sono solo moderatamente rilevanti o rilevanti, i valori di esempio non corrispondono alle tue aspettative o il contesto di utilizzo è limitato, perfeziona la query e controlla un nuovo set di risultati prima di procedere.

Etichette di rilevanza

L’agente di individuazione campi assegna un’etichetta di rilevanza nella colonna Rilevanza del pannello Campi identificati per ogni risultato di campo, indicando la corrispondenza tra il campo e la query.

Se tutti i risultati sono etichettati Moderatamente rilevanti o Rilevanti anziché Altamente rilevanti, la query potrebbe essere troppo ampia o utilizzare una terminologia che non corrisponde ai metadati dello schema. Definisci il prompt con termini più specifici per lingua o dominio che riflettano la modalità di denominazione dei campi.

Valori di esempio

Accanto a ogni suggerimento di campo, l’agente di individuazione campi visualizza valori di esempio tratti dai dati del campo nella sandbox. I valori di esempio consentono di verificare che un campo contenga il tipo di dati previsto prima di selezionarlo.

I valori di esempio sono visibili solo per i campi all’interno delle autorizzazioni di accesso al set di dati. Per informazioni sulla governance dei dati e sulle restrizioni di utilizzo in Experience Platform, consulta la Panoramica sulla governance dei dati.

Se non vengono visualizzati valori di esempio per un campo, il campo potrebbe essere vuoto nella sandbox corrente o le autorizzazioni potrebbero non includere l’accesso al relativo set di dati sottostante. Anche i campi con cardinalità elevata (come i campi Identificatore o UUID) potrebbero non restituire valori di esempio rappresentativi. I valori di esempio sono aggregati e basati sulla frequenza e non sono tracciabili per i singoli profili.

Contesto di utilizzo

Ogni risultato di campo include il contesto di utilizzo che mostra dove viene visualizzato il campo nell’ecosistema di dati:

Pubblico → Set Di Dati → Schema Di → Destinazione

Un campo utilizzato in un pubblico pubblicato, visualizzato in un set di dati attivo, mappato a una destinazione live e definito in uno schema che ha dimostrato l’utilizzo reale nell’ambiente. Questo distingue i campi che si basano attivamente da quelli che esistono solo in una definizione di schema ma che non sono stati utilizzati nella pratica. Utilizza questo segnale insieme all’etichetta di rilevanza e ai valori di esempio per effettuare una selezione del campo più informata.

Risultati in Assistente IA

L’agente di individuazione campi restituisce i risultati in un pannello Campi identificati nella risposta dell’Assistente IA. Nel pannello viene visualizzata una tabella con tre colonne:

Una sezione Risultati spiegati viene visualizzata sotto la tabella Campi identificati e fornisce ulteriore contesto a livello di campo, incluse spiegazioni e dettagli di supporto per ogni risultato. Per informazioni su come navigare nell’interfaccia dell’Assistente di intelligenza artificiale, vedere la Guida dell’interfaccia utente dell’Assistente di intelligenza artificiale.

Usa agente di individuazione campi use-field-discovery-agent

L’utente interagisce con l’agente di individuazione campi tramite l’Assistente IA utilizzando il linguaggio naturale. L’agente richiede una dichiarazione di intenti chiara: una query vaga o troppo breve produce risultati di qualità inferiore o potrebbe non richiamare l’agente di individuazione campi.

Per l’individuazione esplicita dei campi, segui questo flusso di lavoro: identifica l’attributo o il problema di mappatura, invia una query di ricerca dei campi, rivedi i risultati classificati e il contesto di utilizzo nel pannello Campi identificati, seleziona il percorso Nome campo che corrisponde al tuo intento e applica tale percorso XDM in Segment Builder, Query Service o un altro flusso di lavoro.

Per utilizzare l’agente di individuazione campi:

Se necessario, selezionare il menu a discesa Motivazione completata sopra la risposta per confermare che l’agente di individuazione campi ha gestito la richiesta. Nel menu a discesa vengono visualizzati i dettagli del ragionamento che indicano quale agente è stato chiamato.

Per informazioni sull’interfaccia dell’Assistente IA, vedere la Guida dell’interfaccia utente dell’Assistente IA.

Casi d’uso supportati supported-use-cases

Le sezioni seguenti descrivono ciascuna delle tre funzioni di Field Discovery Agent con scenari rappresentativi e prompt di esempio. I risultati includono etichette di rilevanza e contesto di utilizzo per facilitare la valutazione dei campi. Per l’interpretazione dei risultati, vedere Comprendere i risultati. L’agente di individuazione campi restituisce solo le informazioni del campo, non crea tipi di pubblico, non esegue query o invia dati ad altri strumenti. Dopo aver identificato un campo, leggi il relativo percorso XDM dalla colonna Nome campo e utilizzalo nel flusso di lavoro a valle.

Identificare i campi per un concetto aziendale

Quando si descrive un concetto o un attributo di dati specifico, l’agente di individuazione campi restituisce un elenco di campi con una classificazione corrispondente alla descrizione.

“Quali campi rappresentano lo stato o la provincia di origine di un cliente?”
“Trova campi relativi alla data della transazione di acquisto.”
“Quali campi contengono informazioni sul consenso al marketing via e-mail?”

La risposta elenca i campi candidati con la relativa etichetta di rilevanza e il percorso XDM nel pannello Campi identificati. I campi con etichetta Molto rilevanti corrispondono maggiormente al concetto dichiarato. Se i primi risultati sono etichettati Moderatamente rilevanti o Rilevanti anziché Altamente rilevanti, perfeziona la query utilizzando una terminologia più specifica o un contesto a livello di campo.

Ottenere consigli sui campi per un caso d’uso

Quando descrivi un obiettivo o un caso di utilizzo del flusso di lavoro, ad esempio la creazione di un segmento, l’onboarding di un set di dati o la preparazione di una query, l’agente di individuazione campi consiglia di allineare i campi a tale obiettivo, dando priorità in base alla rilevanza.

“Voglio creare un pubblico di clienti di alto valore. Quali campi dovrei usare?”
“Campi consigliati per modellare la propensione all’acquisto.”
“Quali campi includere durante l’onboarding di un set di dati di transazioni di vendita al dettaglio?”

La risposta restituisce un elenco con priorità di campi con contesto di rilevanza. Esamina il contesto di utilizzo per ogni campo consigliato per verificarne l’utilizzo attivo nell’ambiente.

Arricchire il contesto del campo

Quando si richiede informazioni su un campo specifico per nome o percorso, l’agente di individuazione campi restituisce il contesto dettagliato per tale campo, inclusi i valori di esempio, la posizione dello schema e l’utilizzo tra set di dati, tipi di pubblico e destinazioni.

“Ulteriori informazioni sul campo person.name.lastName.”
“Quali valori di esempio esistono per homeAddress.stateProvince?”
“Dove si trova il campo commerce.purchases.value utilizzato nei set di dati e nei tipi di pubblico?”

La risposta restituisce i valori di esempio del campo, la posizione dello schema, i set di dati associati e tutti i tipi di pubblico o le destinazioni in cui viene visualizzato il campo. Esamina questo contesto per confermare che il campo contiene i dati previsti.

Ambito di applicazione ed esclusione in-scope-and-out-of-scope

In questa sezione vengono riepilogate le operazioni consentite e non consentite dall’agente di individuazione campi. Per istruzioni dettagliate sull’attività, vedi Casi d’uso supportati. Per i vincoli di piattaforma, vedere Guardrail e limitazioni.

In ambito

Nell’elenco seguente vengono descritte le attività che l’agente di individuazione campi può eseguire. Utilizzare l’elenco per verificare se l’agente è in grado di soddisfare la richiesta prima di utilizzarlo nel flusso di lavoro.

Fuori ambito

Nell’elenco seguente vengono descritte le azioni che l’agente di individuazione campi non esegue. Utilizzarlo per evitare di fare affidamento sull’agente per operazioni che non rientrano nel suo ambito.

Guardrail e limitazioni guardrails-and-limitations

Questi guardrail sono importanti perché Field Discovery Agent opera all’interno di vincoli a livello di piattaforma che influiscono sulla disponibilità e sulla qualità dei risultati. Utilizzali per interpretare i risultati mancanti, ritardati o incompleti e per risolvere eventuali lacune impreviste con aspettative realistiche.

Knowledge base

L’agente di individuazione campi si basa su una knowledge base che viene periodicamente aggiornata con lo schema e i metadati dell’ambiente Experience Platform in uso. I risultati riflettono lo stato della knowledge base al momento della query, non lo stato in tempo reale degli schemi, e potrebbe verificarsi un ritardo tra l’acquisizione dei dati e quando questi vengono visualizzati nell’agente.

È possibile che i nuovi schemi, campi o set di dati aggiunti all’ambiente non vengano visualizzati immediatamente nei risultati dell’agente di individuazione campi. I risultati potrebbero richiedere tempo per riflettere le modifiche recenti.

Qualità e copertura dei metadati

La qualità dei risultati dipende dalla qualità e dalla completezza dei metadati sul campo nell’ambiente Experience Platform. L’agente utilizza nomi di campo, nomi visualizzati, descrizioni e associazioni di utilizzo per classificare i risultati. I campi con metadati scarsi o mancanti potrebbero non emergere nei risultati o essere di livello inferiore a quello previsto.

Se disponi dell’accesso per la modifica dello schema, puoi migliorare la qualità dei risultati effettuando le seguenti operazioni:

Per informazioni sulla modifica dei nomi e delle descrizioni dei campi visualizzati nell’Editor di schema, vedere Creare e modificare schemi nell’interfaccia utente.

Se non disponi dell’accesso per la modifica dello schema e i risultati sono costantemente scarsi, contatta l’amministratore di Experience Platform o il team di progettazione dati per rivedere i metadati dei campi per gli schemi con cui lavori.

Vincoli di accesso e PII

L’agente di individuazione campi rispetta tutti i controlli di accesso Experience Platform esistenti e opera nel contesto sandbox corrente. Ricevi i risultati solo per i campi negli schemi e nei set di dati a cui sei autorizzato ad accedere.

I valori di esempio sono gestiti dalle stesse autorizzazioni a livello di set di dati. I campi dei set di dati abilitati per il profilo con restrizioni PII restituiscono valori di esempio solo se disponi dell’accesso richiesto. Consulta Valori di esempio per informazioni sulla gestione. L’agente di individuazione campi non ignora le restrizioni di accesso a livello di campo o abilitate per il profilo.

Best practice best-practices

Utilizzare le istruzioni seguenti per ottenere risultati precisi e fruibili dall’agente di individuazione campi.

Esempi di prompt example-prompts

Utilizza questa sezione come libreria di prompt di riferimento rapido. Se non conosci l’agente di individuazione campi, leggi Best practice e Casi d’uso supportati per capire prima quando e perché viene applicata ciascuna funzione.

Richieste di identificazione

Utilizza questi prompt quando conosci il concetto di dati di cui hai bisogno ma non quale campo lo contiene.

“Quale campo contiene lo stato o la regione di un cliente?”
“Trovare i campi relativi allo stato dell’abbonamento e-mail.”
“Quale campo contiene la data del primo acquisto di un cliente?”
“Identificare i campi che rappresentano il valore del ciclo di vita del cliente.”
“Quali campi nello schema del profilo si riferiscono all’iscrizione al programma fedeltà?”

Suggerimenti

Utilizza questi prompt quando avvii un flusso di lavoro e hai bisogno di indicazioni su quali campi includere per un obiettivo specifico.

“Quali campi devo utilizzare per creare un pubblico di ricoinvolgimento?”
“Campi consigliati per un pubblico che include i clienti che non hanno acquistato da 90 giorni.”
“Quali campi sono più utili per modellare il rischio di abbandono?”
“Suggerisci i campi da includere durante la creazione di una segmentazione geografica.”
“Sto creando un modello di propensione all’acquisto. Con quali campi dovrei iniziare?”

Richieste di arricchimento

Utilizza questi prompt quando disponi di un campo candidato e vuoi verificarlo prima di utilizzarlo in un segmento, una query o una mappatura.

“Ulteriori informazioni su homeAddress.stateProvince.”
“Visualizza i valori di esempio per commerce.purchases.value.”
“Dove viene utilizzato person.name.lastName tra i miei set di dati e tipi di pubblico?”
“Quali set di dati contengono il campo web.webPageDetails.URL?”
“È mappato segmentMembership ad alcune destinazioni attive?”

Risoluzione dei problemi troubleshooting

Utilizzare questa sezione quando i risultati sono mancanti, imprevisti o quando non si è certi che l’agente di individuazione campi abbia gestito la richiesta.

Per verificare quale agente ha gestito la richiesta, vedere il passaggio 6 in Utilizzare l’agente di individuazione campi.