Chatbot goal automations

goal automations provide a mechanism to steer the conversation with the widget user such that distinct goals are accomplished for example, when a user first begins to use the widget you may want to collect the user's name and email unlike chatbot tool automations, goal automations are not invoked by the ai model instead, they are a mechanism for building chatbot logic in an easy to understand manner goal automations can be nested, such that a high level goal like "collect user information" may consist of a goal automation that starts by collecting their name, then it invokes a goal automation to collect their email, then that invokes another goal automation to verify the email by sending and confirming a random pin number to the provided email address generally goal automations will make use of either docid\ hhtm2u2jvissechsxnbqr or docid ed 35fg8yaetqtikero5 actions to know when pieces of information have successfully been collected from the chat widget user the parent automation will lookup information to know whether or not a goal automation needs to be invoked when the parent automation invokes the goal automation, the chat conversation is redirected to the goal automation until either of these occur the goal automation invokes another nested goal automation, or the goal automation indicates the goal has been accomplished by executing the "chat goal accomplished" action a key concept to grasp is that when goal automations interact with the ai model, they are all conversing with the same conversation thread as identified by the conversation uuid so the ai model is aware of the full conversation history as the conversation progresses the goal automations provide instructions to the ai model to focus it on performing the desired goal goal automation trigger to build a goal automation, start by selecting the system utility trigger then select the automation chat widget choose the new chat goal message instant trigger the trigger needs no configuration, so just save it to add it to the diagram this trigger functions the same as the new chat message trigger, in that it emits the conversation uuid and the message the chat widget user has sent when the parent chat automation invokes the goal automation, the chat conversation is redirected to the goal automation such that its trigger will fire each time the chat widget user sends a message goal automation action logic the general pattern of a goal automation will be like this one that collects the chat user's email address the above goal automation that collects the chat user's email can be described textually as each time the user sends a chat message, the ai model will see if they entered an email address if not, the ai model will provide a message saying that they cannot be helped until their email address is provided if the ai model's response does not contain json with the provided email address, send the chat response back indicating the conversation cannot continue until their email address is provided otherwise parse the provided email address from the json the ai model returned, save the email in conversation memory, and indicate the goal has been accomplished the parent automation will then wake up and continue where it left off let's walk through the key parts of this example automation the ai model is provided these instructions in the "send agent a message" action you are a chatbot your only goal is to obtain the user's email when you know their email, your only response will be json in this schema {"email" " mailto\ johndoe\@gmail com "} the purpose of emitting json when the email is known is so that the automation has a way to parse out the value from the ai model's response the condition just checks to see if the ai model's response starts with a "{" which indicates the ai model has emitted the json containing the email if json is not emitted, the goal automation sends back the ai model's response to the chat widget otherwise the json is parsed via javascript the parsed email is then stored into conversation memory goal automation completion the "chat goal accomplished" action indicates that the goal automation is finished the parent automation then continues where it left off goal automation execution goal automations are executed by either of these chat automation widget actions the "await chat goal if item not in memory" action is a convenience action that first looks up a named item from the conversation's memory if the item does not have a value, the selected chat goal automation is executed otherwise the parent automation would need to first use an action to fetch the value from conversation memory and a conditional to see if the value existed or not before invoking the "await chat goal" action both actions are similar, in that the parent automation will snooze and the chat conversation will be redirected to the selected goal automation when control passes to the goal automation, a chat message is sent back to the chat widget user the chat reply should inform the user what they need to do to satisfy the goal, generally by providing a piece of information when the goal automation executes the "chat goal accomplished" action, the parent automation wakes up from its snooze and continues its processing after that action the chat conversation is redirected back to the parent nested goal automations goal automations can be nested, when the chat widget user needs to provide multiple pieces of information or perform multiple steps just embed one of the "await chat goal" actions within a goal automation generally the "await chat goal" action is placed right before the "chat goal accomplished" action in this manner, the first goal has been accomplished and then another goal is being started as before, the goal automation is snoozed and the chat conversation redirects to the nested goal automation when the nested goal has been achieved, the parent goal automation wakes up and continues where it left off