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
Newsletter
Log In / Join
Refcards Trend Reports
Events Video Library
Refcards
Trend Reports

Events

View Events Video Library

Related

  • An Overview of Kubernetes Security Projects at KubeCon Europe 2023
  • Keep Your Application Secrets Secret
  • GitOps: Flux vs Argo CD
  • Chaos Engineering and Kafka In Action: Topic Level Idempotence and Retry Check

Trending

  • Columnar Formats for AI Telemetry: Parquet vs Vortex With DuckDB
  • How Performance Engineers Find and Fix Hidden System Bottlenecks
  • MCP Is Coming to Your Desktop Applications
  • A Reference Architecture for Constrained AI-Assisted Design

Draft This article hasn't been published, so readers can't see it.

In moderation This article is waiting for review, so readers can't see it yet.

Deleted This article has been deleted, so readers can't see it.

  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.

By 
Xavier Portilla Edo
DZone Core CORE ·
Jan. 23, 23 · Tutorial
Post on X (opens in a new tab) Share on LinkedIn (opens in a new tab)
3.3K Views

Join the DZone community Save articles, join the discussion, and download Refcards and Trend Reports with a free account.

Join for free Already a member? Log in

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. See the original article here.

Opinions expressed by DZone contributors are their own.

Related

  • An Overview of Kubernetes Security Projects at KubeCon Europe 2023
  • Keep Your Application Secrets Secret
  • GitOps: Flux vs Argo CD
  • Chaos Engineering and Kafka In Action: Topic Level Idempotence and Retry Check

Partner Resources

×

Comments

Loading comments

The comments didn't load

Please try again in a moment.

Likes

Loading

The next likes didn't load. Please try again.

The likes didn't load

Please try again in a moment.

See who liked this

Log in or join DZone for free to see who liked this article.

Log in Join for free
  • RSS
  • X
  • Facebook

ABOUT US

  • About DZone
  • Support and feedback
  • Community research

ADVERTISE

  • Advertise with DZone

CONTRIBUTE ON DZONE

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

LEGAL

  • Terms of Service
  • Privacy Policy

CONTACT US

  • 3343 Perimeter Hill Drive
  • Suite 215
  • Nashville, TN 37211
  • [email protected]

Let's be friends:

  • RSS
  • X
  • Facebook