> For the complete documentation index, see [llms.txt](https://olab4.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://olab4.gitbook.io/help/advanced-topics/ttalk.md). # TTalk {% hint style="info" %} More notes on this in Obsidian: obsidian://open?vault=PKM%20and%20Obsidian\&file=OLab%20stuff%2FTTalk%20Help%20notes Incorporate these into this page and into a more fleshed-out WP page May need to keep learner and moderator and author pages separate {% endhint %} ## What is TTalk? TTalk is a text-based chat service that allows a teacher, moderator or facilitator, to chat with users or learners. One facilitator can chat with up to 8 learners but learners cannot chat with each other. Note that this is real-time with another human, and is not a computer-based chat agent. Be aware that the facilitator may be engaged in chats with several other learners so try to be patient while waiting for them to respond. A synchronous chat session must be arranged i.e. you have to have 2 people to play, one acting as learner and the other as facilitator. If you have not arranged a session, you may skip past the TTalk chat. ## How to facilitate a TTalk chat Not much help is needed on the learner side of a TTalk chat session. A few tips on playing the facilitator role: 1. Watch for learners waiting in the Atrium (bottom left) so you can **Assign** them 2. Pay attention to the script provided by the Course designer about your role (patient? colleague?) 3. Try to stay in the role assigned but use your judgement 4. The timer will show elapsed seconds or a color bar to show who is next due a response 5. When necessary, you can Redirect the learner to a new node 6. **Avoid** the \[CLOSE ROOM] button - this is only used for emergencies. ## How to author a TTalk session This was fairly easy to set up in OLab3 but is a bit more involved in OLab4. We suggest that you design the learner pathways first and then place another (usually simpler) pathway for the moderators to follow. You can convert OLab3 TTalk cases using Import/Export but there are some extra steps. {% hint style="warning" %} Create extra section for this or side channel along with videos {% endhint %} Your existing OLab3 TTalk case will not Import properly without these extra steps. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://olab4.gitbook.io/help/advanced-topics/ttalk.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.