@google-cloud/dialogflow-cx
v4.9.0
Published
Cx client for Node.js
Downloads
41,096
Readme
Dialogflow CX API: Node.js Client
Cx client for Node.js
A comprehensive list of changes in each version may be found in the CHANGELOG.
- [Dialogflow CX API Node.js Client API Reference][client-docs]
- [Dialogflow CX API Documentation][product-docs]
- github.com/googleapis/google-cloud-node/packages/google-cloud-dialogflow-cx
Read more about the client libraries for Cloud APIs, including the older Google APIs Client Libraries, in Client Libraries Explained.
Table of contents:
Quickstart
Before you begin
- [Select or create a Cloud Platform project][projects].
- [Enable billing for your project][billing].
- [Enable the Dialogflow CX API API][enable_api].
- [Set up authentication][auth] so you can access the API from your local workstation.
Installing the client library
npm install @google-cloud/dialogflow-cx
Using the client library
/**
* TODO(developer): Uncomment these variables before running the sample.
*/
// const projectId = 'my-project';
// const location = 'global';
// const agentId = 'my-agent';
// const audioFileName = '/path/to/audio.raw';
// const encoding = 'AUDIO_ENCODING_LINEAR_16';
// const sampleRateHertz = 16000;
// const languageCode = 'en'
// Imports the Google Cloud Some API library
const {SessionsClient} = require('@google-cloud/dialogflow-cx');
/**
* Example for regional endpoint:
* const location = 'us-central1'
* const client = new SessionsClient({apiEndpoint: 'us-central1-dialogflow.googleapis.com'})
*/
const client = new SessionsClient();
const fs = require('fs');
const util = require('util');
// Assumes uuid module has been installed from npm,
// npm i uuid:
const {v4} = require('uuid');
async function detectIntentAudio() {
const sessionId = v4();
const sessionPath = client.projectLocationAgentSessionPath(
projectId,
location,
agentId,
sessionId
);
// Read the content of the audio file and send it as part of the request.
const readFile = util.promisify(fs.readFile);
const inputAudio = await readFile(audioFileName);
const request = {
session: sessionPath,
queryInput: {
audio: {
config: {
audioEncoding: encoding,
sampleRateHertz: sampleRateHertz,
},
audio: inputAudio,
},
languageCode,
},
};
const [response] = await client.detectIntent(request);
console.log(`User Query: ${response.queryResult.transcript}`);
for (const message of response.queryResult.responseMessages) {
if (message.text) {
console.log(`Agent Response: ${message.text.text}`);
}
}
if (response.queryResult.match.intent) {
console.log(
`Matched Intent: ${response.queryResult.match.intent.displayName}`
);
}
console.log(
`Current Page: ${response.queryResult.currentPage.displayName}`
);
}
detectIntentAudio();
Samples
Samples are in the samples/
directory. Each sample's README.md
has instructions for running its sample.
| Sample | Source Code | Try it | | --------------------------- | --------------------------------- | ------ | | Agents.create_agent | source code | ![Open in Cloud Shell][shell_img] | | Agents.delete_agent | source code | ![Open in Cloud Shell][shell_img] | | Agents.export_agent | source code | ![Open in Cloud Shell][shell_img] | | Agents.get_agent | source code | ![Open in Cloud Shell][shell_img] | | Agents.get_agent_validation_result | source code | ![Open in Cloud Shell][shell_img] | | Agents.get_generative_settings | source code | ![Open in Cloud Shell][shell_img] | | Agents.list_agents | source code | ![Open in Cloud Shell][shell_img] | | Agents.restore_agent | source code | ![Open in Cloud Shell][shell_img] | | Agents.update_agent | source code | ![Open in Cloud Shell][shell_img] | | Agents.update_generative_settings | source code | ![Open in Cloud Shell][shell_img] | | Agents.validate_agent | source code | ![Open in Cloud Shell][shell_img] | | Changelogs.get_changelog | source code | ![Open in Cloud Shell][shell_img] | | Changelogs.list_changelogs | source code | ![Open in Cloud Shell][shell_img] | | Deployments.get_deployment | source code | ![Open in Cloud Shell][shell_img] | | Deployments.list_deployments | source code | ![Open in Cloud Shell][shell_img] | | Entity_types.create_entity_type | source code | ![Open in Cloud Shell][shell_img] | | Entity_types.delete_entity_type | source code | ![Open in Cloud Shell][shell_img] | | Entity_types.export_entity_types | source code | ![Open in Cloud Shell][shell_img] | | Entity_types.get_entity_type | source code | ![Open in Cloud Shell][shell_img] | | Entity_types.import_entity_types | source code | ![Open in Cloud Shell][shell_img] | | Entity_types.list_entity_types | source code | ![Open in Cloud Shell][shell_img] | | Entity_types.update_entity_type | source code | ![Open in Cloud Shell][shell_img] | | Environments.create_environment | source code | ![Open in Cloud Shell][shell_img] | | Environments.delete_environment | source code | ![Open in Cloud Shell][shell_img] | | Environments.deploy_flow | source code | ![Open in Cloud Shell][shell_img] | | Environments.get_environment | source code | ![Open in Cloud Shell][shell_img] | | Environments.list_continuous_test_results | source code | ![Open in Cloud Shell][shell_img] | | Environments.list_environments | source code | ![Open in Cloud Shell][shell_img] | | Environments.lookup_environment_history | source code | ![Open in Cloud Shell][shell_img] | | Environments.run_continuous_test | source code | ![Open in Cloud Shell][shell_img] | | Environments.update_environment | source code | ![Open in Cloud Shell][shell_img] | | Experiments.create_experiment | source code | ![Open in Cloud Shell][shell_img] | | Experiments.delete_experiment | source code | ![Open in Cloud Shell][shell_img] | | Experiments.get_experiment | source code | ![Open in Cloud Shell][shell_img] | | Experiments.list_experiments | source code | ![Open in Cloud Shell][shell_img] | | Experiments.start_experiment | source code | ![Open in Cloud Shell][shell_img] | | Experiments.stop_experiment | source code | ![Open in Cloud Shell][shell_img] | | Experiments.update_experiment | source code | ![Open in Cloud Shell][shell_img] | | Flows.create_flow | source code | ![Open in Cloud Shell][shell_img] | | Flows.delete_flow | source code | ![Open in Cloud Shell][shell_img] | | Flows.export_flow | source code | ![Open in Cloud Shell][shell_img] | | Flows.get_flow | source code | ![Open in Cloud Shell][shell_img] | | Flows.get_flow_validation_result | source code | ![Open in Cloud Shell][shell_img] | | Flows.import_flow | source code | ![Open in Cloud Shell][shell_img] | | Flows.list_flows | source code | ![Open in Cloud Shell][shell_img] | | Flows.train_flow | source code | ![Open in Cloud Shell][shell_img] | | Flows.update_flow | source code | ![Open in Cloud Shell][shell_img] | | Flows.validate_flow | source code | ![Open in Cloud Shell][shell_img] | | Generators.create_generator | source code | ![Open in Cloud Shell][shell_img] | | Generators.delete_generator | source code | ![Open in Cloud Shell][shell_img] | | Generators.get_generator | source code | ![Open in Cloud Shell][shell_img] | | Generators.list_generators | source code | ![Open in Cloud Shell][shell_img] | | Generators.update_generator | source code | ![Open in Cloud Shell][shell_img] | | Intents.create_intent | source code | ![Open in Cloud Shell][shell_img] | | Intents.delete_intent | source code | ![Open in Cloud Shell][shell_img] | | Intents.export_intents | source code | ![Open in Cloud Shell][shell_img] | | Intents.get_intent | source code | ![Open in Cloud Shell][shell_img] | | Intents.import_intents | source code | ![Open in Cloud Shell][shell_img] | | Intents.list_intents | source code | ![Open in Cloud Shell][shell_img] | | Intents.update_intent | source code | ![Open in Cloud Shell][shell_img] | | Pages.create_page | source code | ![Open in Cloud Shell][shell_img] | | Pages.delete_page | source code | ![Open in Cloud Shell][shell_img] | | Pages.get_page | source code | ![Open in Cloud Shell][shell_img] | | Pages.list_pages | source code | ![Open in Cloud Shell][shell_img] | | Pages.update_page | source code | ![Open in Cloud Shell][shell_img] | | Security_settings_service.create_security_settings | source code | ![Open in Cloud Shell][shell_img] | | Security_settings_service.delete_security_settings | source code | ![Open in Cloud Shell][shell_img] | | Security_settings_service.get_security_settings | source code | ![Open in Cloud Shell][shell_img] | | Security_settings_service.list_security_settings | source code | ![Open in Cloud Shell][shell_img] | | Security_settings_service.update_security_settings | source code | ![Open in Cloud Shell][shell_img] | | Session_entity_types.create_session_entity_type | source code | ![Open in Cloud Shell][shell_img] | | Session_entity_types.delete_session_entity_type | source code | ![Open in Cloud Shell][shell_img] | | Session_entity_types.get_session_entity_type | source code | ![Open in Cloud Shell][shell_img] | | Session_entity_types.list_session_entity_types | source code | ![Open in Cloud Shell][shell_img] | | Session_entity_types.update_session_entity_type | source code | ![Open in Cloud Shell][shell_img] | | Sessions.detect_intent | source code | ![Open in Cloud Shell][shell_img] | | Sessions.fulfill_intent | source code | ![Open in Cloud Shell][shell_img] | | Sessions.match_intent | source code | ![Open in Cloud Shell][shell_img] | | Sessions.server_streaming_detect_intent | source code | ![Open in Cloud Shell][shell_img] | | Sessions.streaming_detect_intent | source code | ![Open in Cloud Shell][shell_img] | | Sessions.submit_answer_feedback | source code | ![Open in Cloud Shell][shell_img] | | Test_cases.batch_delete_test_cases | source code | ![Open in Cloud Shell][shell_img] | | Test_cases.batch_run_test_cases | source code | ![Open in Cloud Shell][shell_img] | | Test_cases.calculate_coverage | source code | ![Open in Cloud Shell][shell_img] | | Test_cases.create_test_case | source code | ![Open in Cloud Shell][shell_img] | | Test_cases.export_test_cases | source code | ![Open in Cloud Shell][shell_img] | | Test_cases.get_test_case | source code | ![Open in Cloud Shell][shell_img] | | Test_cases.get_test_case_result | source code | ![Open in Cloud Shell][shell_img] | | Test_cases.import_test_cases | source code | ![Open in Cloud Shell][shell_img] | | Test_cases.list_test_case_results | source code | ![Open in Cloud Shell][shell_img] | | Test_cases.list_test_cases | source code | ![Open in Cloud Shell][shell_img] | | Test_cases.run_test_case | source code | ![Open in Cloud Shell][shell_img] | | Test_cases.update_test_case | source code | ![Open in Cloud Shell][shell_img] | | Transition_route_groups.create_transition_route_group | source code | ![Open in Cloud Shell][shell_img] | | Transition_route_groups.delete_transition_route_group | source code | ![Open in Cloud Shell][shell_img] | | Transition_route_groups.get_transition_route_group | source code | ![Open in Cloud Shell][shell_img] | | Transition_route_groups.list_transition_route_groups | source code | ![Open in Cloud Shell][shell_img] | | Transition_route_groups.update_transition_route_group | source code | ![Open in Cloud Shell][shell_img] | | Versions.compare_versions | source code | ![Open in Cloud Shell][shell_img] | | Versions.create_version | source code | ![Open in Cloud Shell][shell_img] | | Versions.delete_version | source code | ![Open in Cloud Shell][shell_img] | | Versions.get_version | source code | ![Open in Cloud Shell][shell_img] | | Versions.list_versions | source code | ![Open in Cloud Shell][shell_img] | | Versions.load_version | source code | ![Open in Cloud Shell][shell_img] | | Versions.update_version | source code | ![Open in Cloud Shell][shell_img] | | Webhooks.create_webhook | source code | ![Open in Cloud Shell][shell_img] | | Webhooks.delete_webhook | source code | ![Open in Cloud Shell][shell_img] | | Webhooks.get_webhook | source code | ![Open in Cloud Shell][shell_img] | | Webhooks.list_webhooks | source code | ![Open in Cloud Shell][shell_img] | | Webhooks.update_webhook | source code | ![Open in Cloud Shell][shell_img] | | Agents.create_agent | source code | ![Open in Cloud Shell][shell_img] | | Agents.delete_agent | source code | ![Open in Cloud Shell][shell_img] | | Agents.export_agent | source code | ![Open in Cloud Shell][shell_img] | | Agents.get_agent | source code | ![Open in Cloud Shell][shell_img] | | Agents.get_agent_validation_result | source code | ![Open in Cloud Shell][shell_img] | | Agents.get_generative_settings | source code | ![Open in Cloud Shell][shell_img] | | Agents.list_agents | source code | ![Open in Cloud Shell][shell_img] | | Agents.restore_agent | source code | ![Open in Cloud Shell][shell_img] | | Agents.update_agent | source code | ![Open in Cloud Shell][shell_img] | | Agents.update_generative_settings | [source code](h