Administra intents con la API

Por lo general, los intents se crean y borran con la consola. Sin embargo, en algunos casos avanzados, tal vez te resulte más fácil usar la API.

Crea un intent

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

Selecciona un protocolo y una versión para la Referencia de intent:

Protocolo	V3	V3beta1
REST	Recurso de intent	Recurso de intent
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

Cerrar

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: El ID del proyecto de Google Cloud.
• REGION_ID: Es el ID de región
• AGENT_ID: Es el ID del 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, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, 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 supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, 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 que se muestra a continuación:

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

Actualiza un intent

El guía sobre mascarillas de campo se muestra cómo actualizar campos individuales de un intent.

Borra 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 de intent

Selecciona un protocolo y una versión para la Referencia de intent:

Protocolo	V3	V3beta1
REST	Recurso de intent	Recurso de intent
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

Cerrar

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: El ID del proyecto de Google Cloud.
• REGION_ID: Es el ID de región
• AGENT_ID: Es el ID del agente.
• INTENT_ID: Es el ID de tu intent, 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, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente 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: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente 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

Deberías recibir un código de estado exitoso (2xx) y una respuesta vacía.