DZone
Thanks for visiting DZone today,
Edit Profile
  • Manage Email Subscriptions
  • How to Post to DZone
  • Article Submission Guidelines
Sign Out View Profile
  • Post an Article
  • Manage My Drafts
Over 2 million developers have joined DZone.
Log In / Join
Refcards Trend Reports Events Over 2 million developers have joined DZone. Join Today! Thanks for visiting DZone today,
Edit Profile Manage Email Subscriptions Moderation Admin Console How to Post to DZone Article Submission Guidelines
View Profile
Sign Out
Refcards
Trend Reports
Events
Zones
Culture and Methodologies Agile Career Development Methodologies Team Management
Data Engineering AI/ML Big Data Data Databases IoT
Software Design and Architecture Cloud Architecture Containers Integration Microservices Performance Security
Coding Frameworks Java JavaScript Languages Tools
Testing, Deployment, and Maintenance Deployment DevOps and CI/CD Maintenance Monitoring and Observability Testing, Tools, and Frameworks
Culture and Methodologies
Agile Career Development Methodologies Team Management
Data Engineering
AI/ML Big Data Data Databases IoT
Software Design and Architecture
Cloud Architecture Containers Integration Microservices Performance Security
Coding
Frameworks Java JavaScript Languages Tools
Testing, Deployment, and Maintenance
Deployment DevOps and CI/CD Maintenance Monitoring and Observability Testing, Tools, and Frameworks
  1. DZone
  2. Popular
  3. Open Source
  4. Dialogflow CX Agents

Dialogflow CX Agents

This tutorial serves as an introduction to Dialogflow CX agents and how to interact with them using the console and the CXCLI.

Xavier Portilla Edo user avatar by
Xavier Portilla Edo
CORE ·
Jan. 23, 23 · Tutorial
Like (1)
Save
Tweet
Share
2.08K Views

Join the DZone community and get the full member experience.

Join For Free

Previous Requisites

Here are the technologies used in this project

  1. Google Cloud Account
  2. Dialogflow API enabled 
  3. Dialogflow CX CLI

What Is a Dialogflow CX Agent?

An agent in Dialogflow CX is the entity that handles all the conversations that we have defined on the Dialogflow CX console with the end users.

An agent is basically an assistant that will manage the state of each user’s conversation when the end users are interacting with the agent through text or audio in multiple channels.

Dialogflow Console

Dialogflow Console is a web interface where you can design your conversations by creating agents and within an agent, creating flows, intents, entity types, etc. On the Dialogflow Console, you can create and interact easily with your agents. To do that you just need to go to the Dialogflow CX Console. This is what it looks like:

Dialogflow CX Console

Once you have created an agent, you can start building conversations! Things that you can do on the console are:

  1. Export an agent: in blob or JSON format
  2. Delete an agent
  3. Conversational components like flows or pages
  4. Modify your NLU by creating intents and entity types
  5. Test your agent

Dialogflow CX CLI

The Dialogflow CX CLI or cxcli is a command-line interface tool that you can use to interact with your Dialogflow CX projects in a terminal. It is an open-source project. With the cxcli you can interact easily with your Dialogflow CX agents.

All the commands that you have available in the cxcli to interact with your agents are located down the cxcli agent command.

Restore

You can restore an agent using a blob file. Right now the Dialogflow CX API, used by the cxcli, only works with the blob format.

The cxcli has a command that allows you to restore an agent.

This a simple example of the cxcli agent restore command:

cxcli agent restore test-agent --project-id test-cx-346408 --location-id us-central1 --input agent.blob


The command above will give you an output like this one:

$ cxcli agent restore test-agent --project-id test-cx-346408 --location-id us-central1 --input agent.blob
INFO Agent restored 


Export

Also, an agent can be exported as a blob file. Right now the Dialogflow CX API, used by the cxcli, only works with the blob format.

The cxcli has a command that allows you to export your agent.

This a simple example of the cxcli agent export command:

cxcli agent export test-agent --project-id test-cx-346408 --location-id us-central1


The command above will give you an output like this one:

$ cxcli agent export test-agent --project-id test-cx-346408 --location-id us-central1
INFO Agent exported to file: agent.blob                    


Delete

The cxcli has a command that allows you to delete your agent.

Below you will find an example of the cxcli agent delete command:

cxcli agent delete test-agent --project-id test-cx-346408 --location-id us-central1


The command above will give you an output like this one:

$ cxcli agent delete test-agent --project-id test-cx-346408 --location-id us-central1
INFO Agent deleted                          


Resources 

If you want to check the full usage of the cxcli agent command, please refer to this page.

If you want to learn more about Dialogflow CX agents, check the official documentation.

Conclusion 

This was a basic tutorial to learn about a Dialogflow CX Agent. As you have seen in this example, creating an agent and interacting with it either with the console or the cxcli is very easy.

I hope this tutorial will be useful to you.

That’s all folks!

Happy coding!

Command-line interface Dialogflow Conversations (software) Open source

Published at DZone with permission of Xavier Portilla Edo, DZone MVB. See the original article here.

Opinions expressed by DZone contributors are their own.

Popular on DZone

  • DevSecOps Benefits and Challenges
  • Core Machine Learning Metrics
  • 9 Ways You Can Improve Security Posture
  • The Real Democratization of AI, and Why It Has to Be Closely Monitored

Comments

Partner Resources

X

ABOUT US

  • About DZone
  • Send feedback
  • Careers
  • Sitemap

ADVERTISE

  • Advertise with DZone

CONTRIBUTE ON DZONE

  • Article Submission Guidelines
  • Become a Contributor
  • Visit the Writers' Zone

LEGAL

  • Terms of Service
  • Privacy Policy

CONTACT US

  • 600 Park Offices Drive
  • Suite 300
  • Durham, NC 27709
  • support@dzone.com
  • +1 (919) 678-0300

Let's be friends: