Use the Platform APIs’ conversation testing operation
to test an agent with two REST calls: launch it, then send a user message.
This endpoint identifies the conversation by userID; it does not use the
session-creation handshake of the customer-facing Chat and voice integrations.
For a customer-facing implementation, start with Chat agents or Voice agents. The recipe below exercises agent behavior through the testing API.
The recipe
Run the recipe
How it works
- The
userIDin the path IS the conversation. Call the same path again and the agent picks up where it left off; call it with a newuserIDand you get a fresh conversation. actionis what the user did.launchstarts the agent from its entry point,textsends something they typed. The full set is in the trace reference.versionchooses which build answers:publishedruns the live version of the environment,draftruns what you are currently editing. A project that has never been published has no published build yet, so usedraftuntil the first publish.- The response is an array of traces describing
what the agent did.
textcarries the words a chat agent said; a voice agent answers withspeakinstead. environmentAliasnames the environment to run. New projects start withmain.