Gestione degli intenti con l'API

In genere, gli intent vengono creati ed eliminati utilizzando la console. Tuttavia, in alcuni scenari avanzati, potresti trovare più semplice utilizzare l'API.

Crea un intent

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

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

Protocollo	V3	V3beta1
REST	Risorsa Intent	Risorsa Intent
RPC	Interfaccia Intent	Interfaccia Intent
C++	IntentsClient	Non disponibile
C#	IntentsClient	Non disponibile
Vai	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, apporta le sostituzioni seguenti:

• PROJECT_ID: l'ID del tuo progetto Google Cloud
• REGION_ID: il tuo ID regione
• AGENT_ID: l'ID del tuo 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 seguente comando 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 consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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, quindi esegui il comando seguente:

$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 alle maschere di campo mostra come aggiornare i singoli campi di un intent.

Elimina un intent

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

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

Protocollo	V3	V3beta1
REST	Risorsa Intent	Risorsa Intent
RPC	Interfaccia Intent	Interfaccia Intent
C++	IntentsClient	Non disponibile
C#	IntentsClient	Non disponibile
Vai	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, apporta le sostituzioni seguenti:

• PROJECT_ID: l'ID del tuo progetto Google Cloud
• REGION_ID: il tuo ID regione
• AGENT_ID: l'ID del tuo agente
• INTENT_ID: l'ID dell'intent, che si trova 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 seguente comando 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 consente di accedere automaticamente all'interfaccia a riga di comando 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.