Use Claude Code to create, test, diagnose and document your Genesys Cloud's Architect flows.
This plugin allows you to:
- Create architect flows of any type
- Document an entire flow
- Run automated tests against Digital flows
- Create flow expressions
- Identify issues with a flow
- Asking questions of a flow
- and more...
- Open Claude Code
- Type the following to add the marketplace for the plugin and install it:
-
Add the marketplace
/plugin marketplace add MakingChatbots/genesys-cloud-plugins -
Install the plugin
/plugin install genesys-cloud-architect@makingchatbots-genesys-cloud-plugins
-
- When asked, provide the Credentials for an OAuth Client with the following permissions:
Architect > Flow > *Architect > Job > *Architect > UI > *Language Understanding > NLU Domain Version > ViewTextbots > *Architect > Dependency Tracking > ViewRouting > Queue > ViewArchitect > Flow Instance > ViewArchitect > Flow Instance > SearchArchitect > Flow Instance Execution Data > ViewArchitect > User Prompt > View
Once you've installed the plugin simply ask Claude to create, explain, test, diagnose flow, and much more...
Here are some examples of what it can do:
Manually dragging boxes in Architect can now become a thing of the past. Simply tell Claude what you want the flow to do and have it create, publish and test it using the Architect Scripting SDK:
Create a Bank bot flow with two intents: "Check Account Balance" (collects an 8-digit AccountNumber slot) and "Find a Branch" (collects a 5-digit ZipCode slot).
The bot:
- Asks "What would you like to do?"
- Detects the intent
- Then asks for the relevant slot
- Exit the bot flow after slot collection
Include 6 utterances per intent with entity-annotated examples. Add intent confirmation prompts like "I think you want to [intent], is that correct?"
Publish the flow, and test it frequently as you build it.
Resulting in a flow:
The more complex a flow becomes the harder it is to understand. Since this plugin allows Claude Code to understand flows, it can be used to document them too...
Document the flow "Bank Bot".
Show me how it hangs together, quote what the bot actually says at each step, and flag anything that looks wrong.
If it is too big for one diagram, split it by responsibility.
The plugin allows Claude Code to run tests against Digital bot flows. This is useful when it's developing flows, or simply to test for edge-cases in existing flows:
Inspect the 'Bank bot' flow and run tests against it to ensure it behaves as expected.
The plugin can create expressions for you, along with an explanation of how they work. It does this by creating a test harness in a Digital bot flow which it can then create and test the expression in.
My Genesys Architect flow needs to extract the 'author' from the JSON retrieved from a participant attribute below:
{ "newsletter": {"makingchatbots": {"author": "Lucas Woodward "}}
Create an expression that returns the value of 'author'. However, if the property (or any of the parent properties) do not exist then return an empty value.
Create a Digital Bot flow to test your expression against different test cases.
Issues in flows can easily go unnoticed, quietly affecting customers. They're now easily identified by simply asking Claude Code to look for them:
Review the flow "Main Intent Router" for problems.
Give me a table of every issue you find, ordered by severity, with what it would mean for a customer and where in the flow to fix it.
It isn't always easy to know why or how the flow behaves in a particular way, so now you can ask how parts of your flow work:
Explain why the "Was the book bought in store?" question in the flow "Main Intent Router" goes silent when the customer doesn't answer.
Use simple illustrations to help me understand.
This is built by me, Lucas Woodward.
I've been building this in public, and engaging with the Genesys community with each milestone. If you'd like to keep up to date with releases then follow me on LinkedIn.
These are some of the other projects I've built:
- Genesys Cloud MCP Server
- Genesys Cloud n8n community node
- Genesys Cloud Chatbot Tester
- many more on my newsletter...
Docs to help understand how this works, or contribute: