dialogflow-cx-conversations_skill

Overview

This skill manages conversations and sessions in Google Dialogflow CX using the v3beta1 REST API. It provides tools to send user input, match intents without changing state, and create test cases for automated validation. Use it to test agent behavior, drive interactive sessions, and manage conversation state programmatically.

How this skill works

The skill calls Dialogflow CX endpoints (detectIntent, matchIntent, testCases) under the API base URL https://dialogflow.googleapis.com/v3beta1 or regional endpoints. It authenticates via gcloud application-default credentials or a service account token, sends JSON query inputs, and returns agent responses and matched intents. Scripts wrap common operations so you can run detect-intent, match-intent, and test-case creation from the command line or CI.

When to use it

• Validate conversational flows before deployment
• Run intent matching checks without altering session state
• Drive automated conversation tests and regression suites
• Perform interactive/manual testing of an agent
• Programmatically manage session state for debugging

Best practices

• Authenticate with a service account in CI and gcloud locally for development
• Use UUIDs or unique session IDs per test to isolate state
• Prefer matchIntent for stateless checks and detectIntent for full conversation flow
• Create test cases that mirror real user turns for reliable validation
• Use regional endpoints to reduce latency and comply with data residency

Example use cases

• Send a user utterance and receive the agent response via detectIntent for end-to-end testing
• Run matchIntent in CI to assert that expected intents are matched without changing session state
• Automate creation of test cases representing regression scenarios and store them with the agent
• Perform manual interactive sessions for debugging context and slot-filling behavior
• Integrate conversation calls into monitoring to detect regressions after agent updates