Gestisci arricchimenti

Applica gli arricchimenti ai campi nei tuoi documenti per rendere più semplici le informazioni significative da trovare e restituire nelle ricerche.

In genere applichi gli arricchimenti ai campi nel momento in cui crei l'arricchimento. Tuttavia, puoi applicare gli arricchimenti ai campi in un secondo momento. Potresti voler applicare un arricchimento esistente a un nuovo campo personalizzato che crei utilizzando, ad esempio, lo strumento SDU. Puoi rimuovere gli arricchimenti che hai applicato anche ai campi.

Per ulteriori informazioni sugli arricchimenti disponibili, consultare i seguenti argomenti:

Per applicare gli arricchimenti a un progetto Content Mining, è necessario utilizzare l'applicazione Content Mining invece di utilizzare l'interfaccia utente Discovery. Quando si utilizza l'applicazione Content Mining, garantisce che gli arricchimenti vengano accettati nel progetto Content Mining. Per ulteriori informazioni sull'applicazione di arricchimenti come un dizionario o un parere di frase a un progetto Content Mining, vedi Arricchisci la tua raccolta.

Per gestire gli arricchimenti, completare i seguenti passaggi:

  1. Dal riquadro di navigazione, aprire la pagina Gestisci raccolte e fare clic su una raccolta per aprirla.

  2. Fai clic sulla scheda Enrichments.

    Viene visualizzato un elenco degli arricchimenti disponibili.

    Puoi identificare gli arricchimenti integrati perché sono categorizzati come tipo System. L'elenco include anche tutti gli arricchimenti personalizzati che sono stati creati in uno dei progetti nella tua istanza del servizio.

  3. Trova l'arricchimento che vuoi applicare o rimuovere.

  4. Fare clic sulla freccia nel campo associato per espandere un elenco di campi.

  5. Effettua una delle operazioni riportate di seguito:

    • Per applicare un arricchimento ai documenti, selezionare il campo o i campi che si desidera arricchire. Puoi applicare gli arricchimenti ai campi text e html e ai campi personalizzati che sono stati aggiunti dai file JSON o CSV caricati o dallo strumento SDU (Smart Document Understanding).

      Se il campo che scegli proviene da un file JSON, dopo aver applicato l'arricchimento, il tipo di dati del campo viene convertito in un array. Il campo viene convertito in un array anche se contiene un singolo valore. Ad esempio, "field1": "Discovery" diventa "field1": ["Discovery"]. Solo i primi 50.000 caratteri di un campo personalizzato da un file JSON vengono arricchiti.

    • Per rimuovere un arricchimento, deselezionare le caselle di spunta per i campi da cui si desidera rimuovere l'arricchimento.

  6. Fare clic su Applica modifiche e rielabora per applicare le modifiche alla raccolta.

Eliminazione di un arricchimento

Puoi eliminare un arricchimento personalizzato che hai creato per insegnare Discovery sul tuo servizio. Gli arricchimenti personalizzati includono dizionari, espressioni regolari, modelli e così via. Per ulteriori informazioni, vedi Aggiunta di risorse specifiche del dominio.

Non puoi eliminare un arricchimento precostruito. Gli arricchimenti preintegrati includono gli arricchimenti Natural Language Understanding, come l'arricchimento delle entità, che sono integrati nel prodotto. Per determinare quali arricchimenti sono integrati, controlla la colonna Type della pagina Enrichments per una raccolta. Gli arricchimenti precostruiti hanno il tipo System.

Per eliminare un arricchimento personalizzato, procedere come segue:

  1. Aprire un progetto che utilizzi l'arricchimento personalizzato.

  2. Fai clic su Gestisci raccolte, quindi apri una raccolta in cui l'arricchimento è in uso.

  3. Dalla pagina Arricchimento di una raccolta, rimuovi l'arricchimento da qualsiasi campo in cui viene applicato.

  4. Fai clic su Applica modifiche e rielabora, quindi attendi che il sistema elabori i documenti nella tua raccolta senza l'arricchimento.

  5. Ripetere il passo precedente per ogni raccolta in ogni progetto in cui viene utilizzato l'arricchimento.

    Ricorda, un arricchimento personalizzato può essere utilizzato da qualsiasi raccolta in qualsiasi progetto all'interno di una singola istanza del servizio Discovery.

  6. Da una qualsiasi delle raccolte che hanno utilizzato l'arricchimento, apri la pagina Arricchimento e fai quindi clic sull'icona di eliminazione per eliminare l'arricchimento.

L'arricchimento personalizzato viene rimosso dall'elenco Arricchimento ovunque in questa istanza del servizio.

Utilizzo dell'API per gestire gli arricchimenti

Per applicare un arricchimento ai dati utilizzando l'API, completa la seguente procedura:

  1. Innanzitutto, devi conoscere l'ID univoco dell'arricchimento che vuoi applicare. Per ulteriori informazioni, consulta ID arricchimento.
  2. Utilizza i metodi Create collection o Update collection per applicare un arricchimento ai documenti in una raccolta. Per ulteriori informazioni, vedi Applica l'arricchimento utilizzando l'API

ID arricchimento

Se vuoi applicare un arricchimento personalizzato che hai creato per una raccolta a un'altra raccolta, devi conoscere l'ID univoco che è stato generato per l'arricchimento quando è stato creato. Utilizza l'API per elencare gli arricchimenti dal progetto in cui è in uso l'arricchimento personalizzato. L'elenco restituito include le informazioni sull'ID arricchimento.

Per gli arricchimenti precompilati, gli ID univoci non cambiano. La seguente tabella elenca gli ID associati a ogni tipo di arricchimento precostruito e identifica le lingue di raccolta per cui l'arricchimento è supportato. Un arricchimento non può essere applicato a una raccolta a meno che il linguaggio di raccolta non sia supportato dall'arricchimento.

ID arricchimento precostruito
Nome ID arricchimento Lingue supportate
Contratti 701db916-fc83-57ab-0000-000000000014 it
Entità 701db916-fc83-57ab-0000-00000000001e ar, de, en, es, fr, it, ja, ko, nl, pt, zh - CN
Parole chiave 701db916-fc83-57ab-0000-000000000018 ar, de, en, es, fr, it, ja, ko, nl, pt, zh - CN
Parte del discorso 701db916-fc83-57ab-0000-000000000002 Tutte le lingue supportate
Opinione del documento 701db916-fc83-57ab-0000-000000000016 ar, de, en, es, fr, it, ja, ko, nl, pt, zh - CN
Table Understanding 701db916-fc83-57ab-0000-000000000012 Tutte le lingue supportate

Per ulteriori informazioni su tutte le lingue supportate, vedi Supporto lingua.

Applica gli arricchimenti utilizzando l'API

Per applicare un arricchimento tramite l'API, completare i seguenti passaggi:

  1. Determinare la base URL per l'endpoint e il token o la chiave API per la distribuzione.

    Per ulteriori informazioni, vedi Creazione di applicazioni personalizzate con l'API.

  2. Ottieni l'ID progetto per il progetto.

    Dall'interfaccia utente del prodotto, andare alla pagina Integra e distribuisci > Visualizza informazioni API, quindi copiare l'ID progetto.

  3. Se non conosci l'ID della raccolta a cui vuoi applicare l'arricchimento, ottieni un elenco delle tue raccolte per trovarlo.

    Ad esempio:

    GET $authentication $url/v2/projects/$project_id/collections?version=2019-11-22
    

    Viene restituito collection_id.

  4. Invia una richiesta GET per restituire la configurazione della raccolta che elenca gli arricchimenti applicati.

    Ad esempio:

    GET $authentication $url/v2/projects/$project_id/collections/$collection_id?version=2019-11-22
    

    Per gli ID arricchimento per gli arricchimenti precostruiti, vedi ID arricchimento.

  5. Aggiungere l'arricchimento che si desidera applicare.

    Ad esempio, per aggiungere l'arricchimento Keywords, puoi includerlo nell'elenco degli arricchimenti. Per prima cosa, ottieni il suo ID dalla tabella.

    L'ID arricchimento delle parole chiave è 701db916-fc83-57ab-0000-000000000018. Per indicare che vuoi applicare l'arricchimento Keywords al contenuto nel campo text dei documenti nella raccolta, puoi rappresentarlo nel seguente formato JSON:

    {
        "enrichment_id" : "701db916-fc83-57ab-0000-000000000018",
        "fields" : [ "text" ]
    }
    

    Tutti gli arricchimenti che specifichi sostituiscono gli arricchimenti predefiniti. Pertanto, se vuoi conservare un arricchimento predefinito, non dimenticarti di includerlo nell'elenco di arricchimenti che applichi alla raccolta. Per un elenco di arricchimenti predefiniti per tipo di progetto, vedi arricchimenti predefiniti per tipo di progetto.

    Ad esempio, per conservare l'arricchimento Entities e aggiungere l'arricchimento Keywords, puoi specificare quanto segue nel corpo della richiesta.

    "enrichments": [
      {
        "enrichment_id": "701db916-fc83-57ab-0000-00000000001e",
        "fields": [
          "text"
        ]
      },
      {
        "enrichment_id": "701db916-fc83-57ab-0000-000000000018",
        "fields": [
          "text"
        ]
      }
    ]
    
  6. Invia il corpo della richiesta JSON aggiornato con il metodo update collection per applicare l'arricchimento alla tua raccolta.

    Ad esempio:

    POST $authentication -d '$requestBody' $url/v2/projects/$project_id/collections/$collection_id?version=2019-11-22
    

Arricchimenti predefiniti per tipo di progetto

Alcuni arricchimenti precostruiti vengono applicati automaticamente alle raccolte in un progetto in base al tipo di progetto. La seguente tabella mostra gli arricchimenti predefiniti applicati a ciascun tipo di progetto.

Arricchimenti predefiniti per tipo di progetto
Questa tabella ha intestazioni di righe e colonne. Le intestazioni di riga identificano i tipi di progetto. Le intestazioni di colonna identificano diversi arricchimenti. Per comprendere quali arricchimenti vengono applicati a un tipo di progetto per impostazione predefinita, vai alla riga che descrive gli arricchimenti e trova le colonne per il tipo di progetto a cui sei interessato.
Arricchimento Document Retrieval Richiamo documenti per contratti Conversational Search Content Mining
Contratti Icona segno di spunta
Entità Icona segno di spunta Icona segno di spunta
Parole chiave
Parte del discorso Icona segno di spunta
Opinione del documento
Table Understanding Icona segno di spunta