IBM Cloud Docs
Gestione dei modelli di lingua personalizzati

Gestione dei modelli di lingua personalizzati

L'interfaccia di personalizzazione include il metodo POST /v1/customizations per creare un modello di lingua personalizzato. L'interfaccia include anche il metodo POST /v1/customizations/train per addestrare un modello personalizzato sui dati più recenti dalla sua risorsa di parole. Per ulteriori informazioni, vedi

L'interfaccia include anche metodi per elencare le informazioni sui modelli linguistici personalizzati, ripristinare un modello personalizzato allo stato iniziale, aggiornare un modello personalizzato ed eliminare un modello personalizzato. Non puoi addestrare, reimpostare, eseguire l'upgrade o eliminare un modello personalizzato mentre il servizio gestisce un'altra operazione su quel modello, inclusa l'aggiunta di risorse al modello.

Elenco dei modelli di lingua personalizzati

L'interfaccia di personalizzazione fornisce due metodi per elencare le informazioni sui modelli di lingua personalizzati che appartengono alle credenziali specificate:

  • Il metodo GET /v1/customizations elenca le informazioni su tutti i modelli linguistici personalizzati o, se si specifica il parametro language, su tutti i modelli linguistici personalizzati per la lingua specificata. Se si specifica una lingua, utilizzare l'identificatore della lingua dal nome del modello base, ad esempio, en-US per un modello inglese statunitense.
  • Il metodo GET /v1/customizations/{customization_id} elenca le informazioni su uno specifico modello di lingua personalizzato. Utilizza questo metodo per eseguire il polling del servizio in merito allo stato di una richiesta di addestramento o di una richiesta di aggiunta di nuove parole.

Entrambi i metodi restituiscono le seguenti informazioni su un modello personalizzato:

  • customization_id identifica il GUID (Globally Unique Identifier) del modello personalizzato. Il GUID viene utilizzato per identificare il modello nei metodi dell'interfaccia.
  • created è la data e l'ora in formato UTC (Coordinated Universal Time) in cui è stato creato il modello personalizzato.
  • updated è la data e l'ora in formato UTC (Coordinated Universal Time) in cui è stata apportata l'ultima modifica al modello personalizzato.
  • language è la lingua del modello personalizzato. Il valore corrisponde all'identificatore della lingua dal nome del modello base. Ad esempio, en-US per un modello in lingua inglese statunitense.
  • dialect è il dialetto della lingua per il modello personalizzato, che non corrisponde necessariamente alla lingua del modello personalizzato per i modelli spagnoli della generazione precedente. Per ulteriori informazioni, vedere la descrizione del campo " dialect " in "Create a custom language model"(Creare un modello di linguaggio personalizzato ).
  • owner identifica le credenziali dell'istanza del servizio proprietaria del modello personalizzato.
  • name è il nome del modello personalizzato.
  • description mostra la descrizione del modello personalizzato, se ne è stata fornita una alla sua creazione.
  • base_model indica il nome del modello di lingua per il quale è stato creato il modello personalizzato.
  • versions fornisce un elenco delle versioni disponibili del modello personalizzato. Ogni elemento dell'array indica una versione del modello di base con cui è possibile utilizzare il modello personalizzato. Esistono versioni multiple solo se il modello personalizzato viene aggiornato a una nuova versione del suo modello base. Altrimenti, viene mostrata solo una singola versione. Per ulteriori informazioni, vedi Elenco delle informazioni sulla versione per un modello personalizzato.

Il metodo restituisce anche un campo status che indica lo stato del modello personalizzato:

  • pending indica che il modello è stato creato. Attende l'aggiunta di dati di addestramento validi (corpora, parole o grammatiche) o il completamento dell'analisi dei dati aggiunti da parte del servizio.
  • ready indica che il modello contiene dati validi ed è pronto per essere addestrato. Se il modello contiene una combinazione di risorse valide e non valide, l'addestramento del modello non riesce a meno che non imposti il parametro di query strict su false. Per ulteriori informazioni, vedi Errori di addestramento.
  • training indica che il modello è in fase di addestramento sui dati.
  • available indica che il modello è addestrato e pronto per l'uso con una richiesta di riconoscimento.
  • upgrading indica che il modello è in fase di upgrade.
  • failed indica che l'addestramento del modello non è riuscito. Esamina le parole nella risorsa di parole del modello per determinare gli errori che hanno impedito l'addestramento del modello.

Inoltre, l'output include un campo " progress " che indica lo stato dell'addestramento di un modello personalizzato. Se hai utilizzato il metodo " POST /v1/customizations/{customization_id}/train " per addestrare correttamente il modello, questo campo avrà il valore " 100". Se il modello non è completamente addestrato e " available", il campo ha un valore di " 0".

Quando si controlla la formazione o l'aggiornamento di un modello personalizzato, si deve sondare il valore del campo " status ", non il valore del campo " progress ". Se l'operazione non riesce per qualsiasi motivo, il valore del campo " status " cambia per riflettere l'errore; il valore del campo " progress " rimane " 0".

Elencare tutti i modelli di lingua personalizzati esempio

Il seguente esempio include il parametro di query language per elencare tutti i modelli di lingua personalizzati in inglese (Stati Uniti) che appartengono alle credenziali specificate:

IBM Cloud

curl -X GET -u "apikey:{apikey}" \
"{url}/v1/customizations?language=en-US"

IBM Cloud Pak for Data IBM Software Hub

curl -X GET \
--header "Authorization: Bearer {token}" \
"{url}/v1/customizations?language=en-US"

Le credenziali possiedono due di questi modelli. Il primo modello è in attesa di dati oppure il servizio ne sta eseguendo l'elaborazione. Il secondo modello è completamente addestrato e pronto per l'uso. Entrambi i modelli personalizzati si basano su modelli della generazione precedente; il primo modello personalizzato è disponibile in due versioni.

{
  "customizations": [
    {
      "customization_id": "74f4807e-b5ff-4866-824e-6bba1a84fe96",
      "created": "2016-06-01T14:21:26.894Z",
      "updated": "2020-01-18T18:42:25.324Z",
      "language": "en-US",
      "dialect": "en-US",
      "versions": [
        "en-US_BroadbandModel.v2018-07-31",
        "en-US_BroadbandModel.v2020-01-16"
      ],
      "owner": "297cfd08-330a-22ba-93ce-1a73f454dd98",
      "name": "Example model",
      "description": "Example custom language model",
      "base_model_name": "en-US_BroadbandModel",
      "status": "pending",
      "progress": 0
    },
    {
      "customization_id": "8391f918-3b76-e109-763c-b7732fae4829",
      "created": "2017-12-02T18:51:37.291Z",
      "updated": "2017-12-02T20:02:10.624Z",
      "language": "en-US",
      "dialect": "en-US",
      "versions": [
        "en-US_BroadbandModel.v2017-11-15"
      ],
      "owner": "297cfd08-330a-22ba-93ce-1a73f454dd98",
      "name": "Example model two",
      "description": "Example custom language model two",
      "base_model_name": "en-US_BroadbandModel",
      "status": "available",
      "progress": 100
    }
  ]
}

Elencare un esempio specifico di modello linguistico personalizzato

Il seguente esempio restituisce informazioni sul modello personalizzato con l'ID di personalizzazione specificato:

IBM Cloud

curl -X GET -u "apikey:{apikey}" \
"{url}/v1/customizations/{customization_id}"

IBM Cloud Pak for Data IBM Software Hub

curl -X GET \
--header "Authorization: Bearer {token}" \
"{url}/v1/customizations/{customization_id}"

La risposta ripete le informazioni dell'esempio precedente:

{
  "customization_id": "74f4807e-b5ff-4866-824e-6bba1a84fe96",
  "created": "2016-06-01T14:21:26.894Z",
  "updated": "2020-01-18T18:42:25.324Z",
  "language": "en-US",
  "dialect": "en-US",
  "versions": [
    "en-US_BroadbandModel.v2018-07-31",
    "en-US_BroadbandModel.v2020-01-16"
  ],
  "owner": "297cfd08-330a-22ba-93ce-1a73f454dd98",
  "name": "Example model",
  "description": "Example custom language model",
  "base_model_name": "en-US_BroadbandModel",
  "status": "pending",
  "progress": 0
}

Reimpostazione di un modello di lingua personalizzato

Utilizza il metodo POST /v1/customizations/{customization_id}/reset per reimpostare un modello personalizzato. La reimpostazione di un modello rimuove tutti i corpora e tutte le parole dal modello, inizializzando il modello al suo stato alla creazione. Il metodo non elimina il modello stesso o i metadati quali il suo nome e la sua lingua. Tuttavia, quando reimposti un modello, la sua risorsa di parole è vuota e deve essere ricreata aggiungendo corpora e parole.

Ripristina un modello di lingua personalizzato esempio

Il seguente esempio reimposta il modello personalizzato con l'ID di personalizzazione specificato:

IBM Cloud

curl -X POST -u "apikey:{apikey}" \
"{url}/v1/customizations/{customization_id}/reset"

IBM Cloud Pak for Data IBM Software Hub

curl -X POST \
--header "Authorization: Bearer {token}" \
"{url}/v1/customizations/{customization_id}/reset"

Eliminazione di un modello di lingua personalizzato

Utilizza il metodo DELETE /v1/customizations/{customization_id} per eliminare un modello di lingua personalizzato di cui non hai più bisogno. Il metodo elimina tutti i corpora e tutte le parole associati al modello personalizzato e il modello stesso. Utilizza questo metodo con cautela: un modello personalizzato e i relativi dati non possono essere riacquisti una volta che hai eliminato il modello.

Eliminare un modello linguistico personalizzato esempio

Il seguente esempio elimina il modello personalizzato con l'ID di personalizzazione specificato:

IBM Cloud

curl -X DELETE -u "apikey:{apikey}" \
"{url}/v1/customizations/{customization_id}"

IBM Cloud Pak for Data IBM Software Hub

curl -X DELETE \
--header "Authorization: Bearer {token}" \
"{url}/v1/customizations/{customization_id}"