Gestione degli intenti con l'API

Normalmente, crei ed elimini gli intent utilizzando la console. Tuttavia, in alcuni scenari avanzati, potrebbe essere più semplice usare l'API.

Creare un intent

I seguenti esempi mostrano come chiamare il metodo Create per il tipo Intent. Vai al riferimento dell'API Intent

Seleziona un protocollo e una versione per il riferimento dell'intent:

Protocollo	V3	V3beta1
REST	Risorsa intent	Risorsa intent
RPC	Interfaccia dell'intent	Interfaccia dell'intent
C++	IntentsClient	Non disponibile
C#	IntentsClient	Non disponibile
Go	IntentsClient	Non disponibile
Java	IntentsClient	IntentsClient
Node.js	IntentsClient	IntentsClient
PHP	Non disponibile	Non disponibile
Python	IntentsClient	IntentsClient
Ruby	Non disponibile	Non disponibile

Close

REST

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

• PROJECT_ID: l'ID del tuo progetto Google Cloud
• REGION_ID: il tuo ID regione
• AGENT_ID: il tuo ID agente

Metodo HTTP e URL:

POST https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents

Corpo JSON della richiesta:

{
  "displayName": "My intent display name"
}

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando di gcloud. . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents"

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents/INTENT_ID",
  "displayName": "My intent display name",
  "priority": 500000
}

Aggiorna un intent

La guida alla maschera per i campi mostra come aggiornare i singoli campi di un intent.

Eliminare un intent

I seguenti esempi mostrano come chiamare il metodo Delete per il tipo Intent. Vai al riferimento dell'API Intent

Seleziona un protocollo e una versione per il riferimento dell'intent:

Protocollo	V3	V3beta1
REST	Risorsa intent	Risorsa intent
RPC	Interfaccia dell'intent	Interfaccia dell'intent
C++	IntentsClient	Non disponibile
C#	IntentsClient	Non disponibile
Go	IntentsClient	Non disponibile
Java	IntentsClient	IntentsClient
Node.js	IntentsClient	IntentsClient
PHP	Non disponibile	Non disponibile
Python	IntentsClient	IntentsClient
Ruby	Non disponibile	Non disponibile

Close

REST

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

• PROJECT_ID: l'ID del tuo progetto Google Cloud
• REGION_ID: il tuo ID regione
• AGENT_ID: il tuo ID agente
• INTENT_ID: il tuo ID intent, presente nella risposta di creazione

Metodo HTTP e URL:

DELETE https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents/INTENT_ID

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando di gcloud. . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     "https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents/INTENT_ID"

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents/INTENT_ID" | Select-Object -Expand Content

Dovresti ricevere un codice di stato riuscito (2xx) e una risposta vuota.