Gestionar los intents con la API

Normalmente, los intents se crean y eliminan mediante la consola. Sin embargo, en algunos casos avanzados, puede que te resulte más fácil usar la API.

Crear una intención

En los siguientes ejemplos se muestra cómo llamar al método Create para el tipo Intent. Ir a la referencia de la API Intent

Selecciona un protocolo y una versión para la referencia de Intent:

Protocolo	V3	V3beta1
REST	Recurso de intención	Recurso de intención
RPC	Interfaz de intents	Interfaz de intents
C++	IntentsClient	No disponible
C#	IntentsClient	No disponible
Go	IntentsClient	No disponible
Java	IntentsClient	IntentsClient
Node.js	IntentsClient	IntentsClient
PHP	No disponible	No disponible
Python	IntentsClient	IntentsClient
Ruby	No disponible	No disponible

Close

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_ID: tu ID de proyecto de Google Cloud
• REGION_ID: tu ID de región
• AGENT_ID: tu ID de agente

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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

Deberías recibir una respuesta JSON similar a la siguiente:

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

Actualizar un intent

En la guía de máscaras de campo se explica cómo actualizar campos concretos de una intención.

Eliminar un intent

En los siguientes ejemplos se muestra cómo llamar al método Delete para el tipo Intent. Ir a la referencia de la API Intent

Selecciona un protocolo y una versión para la referencia de Intent:

Protocolo	V3	V3beta1
REST	Recurso de intención	Recurso de intención
RPC	Interfaz de intents	Interfaz de intents
C++	IntentsClient	No disponible
C#	IntentsClient	No disponible
Go	IntentsClient	No disponible
Java	IntentsClient	IntentsClient
Node.js	IntentsClient	IntentsClient
PHP	No disponible	No disponible
Python	IntentsClient	IntentsClient
Ruby	No disponible	No disponible

Close

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

• PROJECT_ID: tu ID de proyecto de Google Cloud
• REGION_ID: tu ID de región
• AGENT_ID: tu ID de agente
• INTENT_ID: el ID de tu intención, que se encuentra en la respuesta de creación

Método HTTP y URL:

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

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Ejecuta el comando siguiente:

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: El siguiente comando presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, ejecuta gcloud auth list.

Ejecuta el comando siguiente:

$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

Deberías recibir un código de estado que indique que la operación se ha realizado correctamente (2xx) y una respuesta vacía.