docs: add update intent code sample (#852)

dialogflow/system-test/update-intent.test.js

@@ -0,0 +1,51 @@
+// Copyright 2021 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+'use strict';
+
+const {assert} = require('chai');
+const {describe, before, it} = require('mocha');
+const execSync = require('child_process').execSync;
+const uuid = require('uuid');
+const dialogflow = require('@google-cloud/dialogflow');
+const exec = cmd => execSync(cmd, {encoding: 'utf8'});
+const projectId =
+  process.env.GCLOUD_PROJECT || process.env.GOOGLE_CLOUD_PROJECT;
+const intentID = [];
+
+describe('update intent', () => {
+  const intentClient = new dialogflow.IntentsClient();
+  const cmd = 'node update-intent.js';
+  const displayName = `fake_display_name_${uuid.v4().split('-')[0]}`;
+
+  before('get intent ID', async () => {
+    // The path to identify the agent that owns the intents.
+
+    const projectAgentPath = intentClient.projectAgentPath(projectId);
+
+    const intentRequest = {
+      parent: projectAgentPath,
+    };
+
+    const [response] = await intentClient.listIntents(intentRequest);
+    response.forEach(intent => {
+      intentID.push(intent.name.split('/')[4]);
+    });
+  });
+
+  it('should update an intent using fieldmasks', async () => {
+    const output = exec(`${cmd} ${projectId} ${intentID[0]} ${displayName}`);
+    assert.include(output, displayName);
+  });
+});

dialogflow/update-intent.js

@@ -0,0 +1,48 @@
+// Copyright 2021 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+'use strict';
+
+process.env.DEBUG = 'dialogflow:debug'; // enables lib debugging statements
+
+async function main(projectId, intentId, displayName) {
+  const {IntentsClient} = require('@google-cloud/dialogflow');
+
+  const intentClient = new IntentsClient();
+
+  const agentPath = intentClient.projectAgentPath(projectId);
+  const intentPath = agentPath + '/intents/' + intentId;
+
+  const intent = await intentClient.getIntent({name: intentPath});
+  intent[0].displayName = displayName;
+  const updateMask = {
+    paths: ['display_name'],
+  };
+
+  const updateIntentRequest = {
+    intent: intent[0],
+    updateMask: updateMask,
+    languageCode: 'en',
+  };
+
+  //Send the request for update the intent.
+  const result = await intentClient.updateIntent(updateIntentRequest);
+  console.log(result);
+}
+
+process.on('unhandledRejection', err => {
+  console.error(err.message);
+  process.exitCode = 1;
+});
+main(...process.argv.slice(2));