In order to ensure a quality user experience, it is important that the new questions and responses clients submit will work within the parameters of our AI model. Before creating new content, you should test your chatbot to see if already provides a response to the proposed question. If the chatbot answers the proposed question with content from the knowledge base, you can update the existing response rather than creating a new question from scratch. If the chatbot answers the proposed question with relevant suggestion boxes, you can select which question(s) you would like to update the response(s) for rather than creating a new question from scratch.


IMPORTANT: Do not change or delete any office contact variables (i.e. !{office}-office) from a response you are editing. Office contact variables trigger the chatbot to ask the user to select their desired office. Removing one of these variables from a response will affect the functionality of the question for any other departments or offices included in the chatbot.


Here are some best practices to follow when creating new custom questions and responses:


Creating new questions:


  • Think about the purpose and goal for the question.The AI model must be able to determine the intent of the question in order to provide the appropriate response. 

  • Write in question format and make sure it is a full sentence with both a noun and verb.

  • Make sure that the question is direct and concise. Avoid submitting questions that are too short and vague or questions that are too long and provide unnecessary information. 

  • Speak student; avoid using jargon, acronyms, and abbreviations by spelling out full names.

  • Avoid greetings or other pleasantries (examples: Hello, Hi, Good morning bot).

  • Avoid including your school name or the specific name of your portal.

  • Avoid specific campus locations, room names, and numbers.

  • Use staff member titles rather than specific names, since people change more often than positions: 

    • Example: use the title Financial Aid Director instead of the name of the Director

  • Combine program-specific questions into a more general question rather than submitting program-specific content:

    • Example: Instead of asking “Which campus is the police academy on?” And “Which campus is the Biology Lab on?” ask “How can I figure out where the classes for my program will be located?")

  • Make sure any questions you submit fall within your contract areas or are part of your out-of-library (OOL) limit. 


Writing responses:


  • Make sure the response provides a clear and direct response to the question it is attached to.

  • Use existing variables when appropriate to reduce the need for upkeep later; remember you can also create your own variables.

  • Use hyperlinks to keep responses concise and evergreen. 

  • Avoid year-specific information if possible; try to write a response that will be relevant for a longer period of time so that the response will not need to be reviewed as often.

  • Avoid starting responses with “yes” or “no” since the question could be asked in many different ways and a yes/no response is not always appropriate.