How makingchatbots/genesys-cloud-chatbot-tester works
The CLI tests Genesys Cloud Web Messenger deployments through two workflows: deterministic scripted dialogues and AI-driven conversations. Both ultimately exercise the chatbot through the tester library’s guest session and conversation API. Scripted execution is visible in the sampled command and parser; the README documents AI testing and its providers, but the AI command’s orchestration was not sampled, so those internal links are marked unverified where needed.
Main entry points: createAiTestCommand.ts AI test command · createScriptedTestCommand.ts Scripted test · WebMessengerGuestSession.ts Guest session · Conversation.ts Conversation API
Components 20
CLI workflows
- CLI entry
packages/genesys-cloud-chatbot-tester-cli/src/createCli.ts - Scripted test
packages/genesys-cloud-chatbot-tester-cli/src/commands/scriptedTest/createScriptedTestCommand.ts - YAML reader
packages/genesys-cloud-chatbot-tester-cli/src/fileSystem/yamlFileReader.ts - Script parser
packages/genesys-cloud-chatbot-tester-cli/src/commands/scriptedTest/testScript/parseTestScript.ts - Scenario results
packages/genesys-cloud-chatbot-tester-cli/src/commands/scriptedTest/ScenarioResult.ts
AI testing
- AI test command
packages/genesys-cloud-chatbot-tester-cli/src/commands/aiTest/createAiTestCommand.ts - Prompt generation
packages/genesys-cloud-chatbot-tester-cli/src/commands/aiTest/prompt/generation/promptGenerator.ts - Conversation stopping
packages/genesys-cloud-chatbot-tester-cli/src/commands/aiTest/prompt/shouldEndConversation.ts - Completion interface
packages/genesys-cloud-chatbot-tester-cli/src/commands/aiTest/chatCompletionClients/chatCompletionClient.ts - ChatGPT client
packages/genesys-cloud-chatbot-tester-cli/src/commands/aiTest/chatCompletionClients/chatGpt/createChatCompletionClient.ts - Gemini client
packages/genesys-cloud-chatbot-tester-cli/src/commands/aiTest/chatCompletionClients/googleGemini/createChatCompletionClient.ts - AI result output
packages/genesys-cloud-chatbot-tester-cli/src/commands/aiTest/output/saveOutputJson.ts
Web Messenger runtime
- Conversation API
packages/genesys-cloud-chatbot-tester/src/Conversation.ts - Guest session
packages/genesys-cloud-chatbot-tester/src/genesys/WebMessengerGuestSession.ts - Message ordering
packages/genesys-cloud-chatbot-tester/src/genesys/message-delayer/ReorderedMessageDelayer.ts - Message types
packages/genesys-cloud-chatbot-tester/src/genesys/StructuredMessage.ts
Genesys integration
- Genesys deployment
- OpenAI API
- Google Gemini API
Other components
- CLI user
Connections 22
- CLI user → CLI entry: runs command
- CLI entry → Scripted test: registers
packages/genesys-cloud-chatbot-tester-cli/src/createCli.ts - CLI entry → AI test command: registers
packages/genesys-cloud-chatbot-tester-cli/src/createCli.ts - Scripted test → YAML reader: reads script
packages/genesys-cloud-chatbot-tester-cli/src/commands/scriptedTest/createScriptedTestCommand.ts - Scripted test → Script parser: extracts scenarios
packages/genesys-cloud-chatbot-tester-cli/src/commands/scriptedTest/createScriptedTestCommand.ts - Scripted test → Scenario results: records outcomes
packages/genesys-cloud-chatbot-tester-cli/src/commands/scriptedTest/createScriptedTestCommand.ts - Script parser → Conversation API: creates conversation steps
packages/genesys-cloud-chatbot-tester-cli/src/commands/scriptedTest/testScript/parseTestScript.ts - Scripted test → Conversation API: runs scenarios
packages/genesys-cloud-chatbot-tester-cli/src/commands/scriptedTest/createScriptedTestCommand.ts - Conversation API → Guest session: sends and receives
packages/genesys-cloud-chatbot-tester/src/Conversation.ts - Guest session → Genesys deployment: opens guest session
packages/genesys-cloud-chatbot-tester/src/genesys/WebMessengerGuestSession.ts - Guest session → Message ordering: buffers messages
packages/genesys-cloud-chatbot-tester/src/genesys/WebMessengerGuestSession.ts - Message ordering → Message types: orders responses
packages/genesys-cloud-chatbot-tester/src/genesys/message-delayer/ReorderedMessageDelayer.ts - Guest session → Message types: parses responses
packages/genesys-cloud-chatbot-tester/src/genesys/WebMessengerGuestSession.ts - AI test command → Prompt generation: builds prompts
packages/genesys-cloud-chatbot-tester-cli/src/commands/aiTest/createAiTestCommand.ts - AI test command → Completion interface: requests completions
packages/genesys-cloud-chatbot-tester-cli/src/commands/aiTest/createAiTestCommand.ts - AI test command → Conversation API: tests deployment
- AI test command → Conversation stopping: checks stop phrases
packages/genesys-cloud-chatbot-tester-cli/src/commands/aiTest/createAiTestCommand.ts - AI test command → AI result output: saves results
packages/genesys-cloud-chatbot-tester-cli/src/commands/aiTest/createAiTestCommand.ts - Completion interface → ChatGPT client: implemented by
packages/genesys-cloud-chatbot-tester-cli/src/commands/aiTest/chatCompletionClients/chatGpt/createChatCompletionClient.ts - Completion interface → Gemini client: implemented by
packages/genesys-cloud-chatbot-tester-cli/src/commands/aiTest/chatCompletionClients/googleGemini/createChatCompletionClient.ts - ChatGPT client → OpenAI API: requests completions
packages/genesys-cloud-chatbot-tester-cli/src/commands/aiTest/chatCompletionClients/chatGpt/createChatCompletionClient.ts - Gemini client → Google Gemini API: requests completions
packages/genesys-cloud-chatbot-tester-cli/src/commands/aiTest/chatCompletionClients/googleGemini/createChatCompletionClient.ts