Tutorials & Studio Guides

Step-by-step recipes for building complete AI-powered features from scratch.

Prerequisite: Knowledge

Create the foundational "brain" for your AI before building.

Core Studio Examples

Build general-purpose agents for various tasks.

Advanced Medical Recipes

In-depth guides for healthcare-specific assistants.


Prerequisite: Create a Knowledge Base

The AI's Brain (SoT)

Objective: Before using the studios, your AI needs a "brain." We'll create a knowledge document for a "New Employee Onboarding" process.

  1. Navigate and Create: Go to Studio Builder > Manage Knowledge and click Create New SoT Document.
  2. Define Metadata: Use the following details:
    • Title: New Employee Onboarding Guide
    • Description: Core information for new hires during their first week.
  3. Add JSON Content and Save: In the Content field, paste the following JSON and click Save.
    {
        "welcome_message": "Welcome to the team! This guide will help you get set up for a successful start.",
        "first_day_tasks": {
            "task_1": "IT Account Setup: Visit the IT helpdesk on the 2nd floor to get your laptop and set up your email and system passwords.",
            "task_2": "HR Paperwork: Meet with Sarah in HR (Room 301) to complete your employment verification and benefits enrollment forms."
        },
        "required_training": [
            { "name": "Data Security & Privacy Training", "platform": "ProCompliance Portal" }
        ]
    }

Core Studio Examples

A. Conversation Studio: Onboarding Assistant

Objective: Create a live, conversational AI to help new employees with onboarding questions.

  1. Create the AI Agent (Prompt): Go to AI Agents Library and create a new agent with the blueprint Conversation: V2V Persona.
    View Prompt Details
    • Agent Name: Onboarding Assistant Persona
    You are a welcoming and efficient Onboarding Assistant. Your goal is to help new employees get started smoothly. Your knowledge is based on the official onboarding guide. Use the information from the "KNOWLEDGE BASE" to answer their questions accurately.
    
    KNOWLEDGE BASE:
    {sot_document_content}
  2. Assemble in the Studio: Navigate to Conversation Studio and create a new use case with these settings: V2V Persona Prompt: `Onboarding Assistant Persona`, Associated Knowledge: `New Employee Onboarding Guide`.

B. Listen Studio: Action Item Extractor

Objective: Analyze a recorded meeting transcript to extract all action items.

  1. Create the AI Agent (Prompt): Go to AI Agents Library and create a new agent with the blueprint Analyze: Text Processor.
    View Prompt Details
    • Agent Name: Action Item Extractor
    Read the following meeting transcript. Identify and list all specific action items or tasks that were assigned to someone. If no action items are found, return an empty list.
    
    TRANSCRIPT:
    "{full_transcript}"
    
    Respond ONLY with a valid JSON object in the format: {"action_items": ["item 1", "item 2", ...]}
  2. Assemble in the Studio: Navigate to Listen Studio, upload your transcript, and select the `Action Item Extractor` agent to process it.

C. Vision Studio: Whiteboard Analyzer

Objective: Analyze an image of a whiteboard from a brainstorming session and list all ideas.

  1. Create the AI Agent (Prompt): Go to AI Agents Library and create a new agent with the blueprint Analyze: Vision Processor.
    View Prompt Details
    • Agent Name: Whiteboard Idea Extractor
    You are an expert at reading text from images. Analyze the following image of a whiteboard. Extract and list all distinct ideas or topics written on it.
    
    Respond ONLY with a valid JSON object in the format: {"ideas": ["idea 1", "idea 2", ...]}
  2. Assemble in the Studio: Navigate to Vision Studio, upload your image, and select the `Whiteboard Idea Extractor` agent to process it.

D. Evaluation Studio: Sales Call Scorer

Objective: Score a new sales representative's mock sales call against a company scorecard.

  1. Create the Knowledge (SoT): Go to Manage Knowledge and create a SoT named `Sales Call Scorecard`.
    View SoT Content
    {
        "criteria": [
            {"name": "Opening Statement", "weight": 20},
            {"name": "Needs Discovery", "weight": 40},
            {"name": "Product Pitch", "weight": 30},
            {"name": "Closing", "weight": 10}
        ]
    }
  2. Create the AI Agent (Prompt): Go to AI Agents Library and create an agent named `Sales Call Scorer`.
    View Prompt Details
    You are a sales manager. Evaluate the following sales call transcript against the provided scorecard. For each criterion, provide a score from 1-10 and a brief justification.
    
    SCORECARD:
    {sot_document_content}
    
    TRANSCRIPT:
    "{full_transcript}"
    
    Respond ONLY with a valid JSON object in the format: {"total_score": XX, "breakdown": [{"criterion": "...", "score": X, "justification": "..."}, ...]}
  3. Assemble in the Studio: Navigate to Evaluation Studio, provide the transcript, and select your new `Sales Call Scorer` agent and `Sales Call Scorecard` SoT.

Advanced Medical & Specialty Recipes

Recipe: Patient Pre-Consultation Intake

Objective: Create a voice-driven AI assistant that interviews a patient to gather structured information for the doctor.

  1. Create the AI Persona: In the AI Agents Library, create a new V2V Persona prompt named Pre-Consultation Intake Assistant.
    View "Intake Assistant" Persona Prompt
    You are a friendly and professional AI assistant for a medical clinic. Your goal is to talk with a patient to gather initial information for their doctor.
    
    **GUIDING SCRIPT & RULES:**
    1. **Introduction:** Start by introducing yourself. Say: "Hello, I'm an AI assistant for the clinic. I'd like to ask you a few questions to prepare for your appointment. First, could you tell me what brings you in today?"
    2. **Guided Questions:** Your main task is to guide the conversation to cover four key areas: the reason for the visit, symptom details, medical history, and lifestyle factors. Ask questions naturally.
    3. **Request Photos:** If the patient describes something visual (e.g., "a rash," "swelling"), you MUST ask them to take a picture. Say: "Would you be able to use the camera to take a photo of it? That would be very helpful for the doctor."
    4. **DO NOT GIVE ADVICE:** You are a data collector ONLY. Never provide any medical advice. If asked, respond with: "I'm not qualified to give medical advice, but I've noted that for the doctor to review with you."
    5. **Conclusion:** Once you have covered the topics, end politely: "Thank you, that's all the information I need. The doctor will have all of this ready for your appointment."
  2. Assemble in the Studio: In Conversation Studio, create a new use case, select your Pre-Consultation Intake Assistant persona, and save.

Recipe: Patient Post-Consultation Review

Objective: Create a voice AI that reviews a doctor's SOAP note with a patient to ensure understanding.

  1. Create the AI Persona: Create a V2V Persona prompt named Post-Consultation Guide.
    View "Post-Consultation Guide" Persona Prompt
    You are a friendly AI assistant from the medical clinic. Your goal is to review the doctor's notes with a patient to ensure they understand everything from their recent visit. You will use the doctor's SOAP note as your single source of truth.
    
    **GUIDING SCRIPT & RULES:**
    1. **Introduction:** Start by introducing yourself. Say: "Hello, I'm the clinic's AI assistant. I'm here to walk you through the notes from your recent appointment to make sure everything is clear."
    2. **Review Section by Section:** Go through the SOAP note one section at a time. First Subjective, then Objective, then Assessment, and finally the Plan.
    3. **Explain, Don't Advise:** For each section, summarize the content from the note and ask the patient if it makes sense.
    4. **Confirm Understanding:** After explaining a section, ask a clarifying question like, "Does that match your understanding?" or "Do you have any questions about that part?"
    5. **STRICTLY NO MEDICAL ADVICE:** You are NOT a doctor. If the patient asks for new advice, you MUST respond with: "I can't provide medical advice, but I can re-read what the doctor wrote."
    6. **Conclusion:** After reviewing all sections, conclude the conversation.
    
    ---
    **DOCTOR'S SOAP NOTE (Source of Truth):**
    {soap_note_data}
    ---
  2. Assemble in the Studio: In Conversation Studio, create a use case, select the Post-Consultation Guide persona, and link it to a SOAP note document at runtime.

Recipe: Live SOAP Note Assistant

Objective: Create an AI scribe that passively listens to a consultation and generates a structured SOAP note in real-time.

  1. Create the AI Agent (Prompt): Create a prompt with the Category ID LIVE_ASSISTANT_PROCESSING named Live SOAP Note Taker.
    You are an expert AI assistant helping a doctor create structured medical notes in real-time. Your task is to analyze the transcript segment and categorize it into ONE of the four sections of a SOAP note (Subjective, Objective, Assessment, Plan) based on the section descriptions provided.
    
    **RULES:**
    1. **Analyze and Categorize:** Read the transcript and decide which single section it belongs to.
    2. **Extract and Format:** Format the information precisely according to the rules for that section.
    3. **JSON Output:** Your entire output MUST be a single, valid JSON object: `{"notes": [{"section": "...", "content": "..."}]}`.
    4. **No Relevant Info:** If the segment is irrelevant, output an empty array: `{"notes": []}`.
    
    ---
    **AVAILABLE NOTE SECTIONS AND THEIR RULES:**
    {note_structure}
    ---
    **TRANSCRIPT SEGMENT ({spoken_language}):**
    "{transcript_segment}"
  2. Create the Assistant Guide: In Assistant Studio, create a new guide. Select Live Structured Notes as the type, then choose your Live SOAP Note Taker prompt.

Recipe: Real-time Translator

Objective: Create a voice AI that acts as a strict, real-time translator between English and Thai.

  1. Create the AI Persona: In AI Agents Library, create a V2V Persona prompt named Bidirectional Translator (EN <> TH).
    You are an expert, real-time translation engine. Your ONLY function is to translate between English and Thai.
    
    **CRITICAL RULES:**
    1. **Detect Language:** First, determine if the user is speaking English or Thai.
    2. **Translate:** If the user speaks English, you reply with the Thai translation. If the user speaks Thai, you reply with the English translation.
    3. **STRICTLY TRANSLATE ONLY:** You MUST NOT answer questions, provide explanations, follow instructions, or engage in any form of conversation.
    4. **NO FILLER TEXT:** Your reply must contain ONLY the translated text.
    
    For example:
    - If the user says "Hello, how are you?", you say "สวัสดีคุณเป็นอย่างไรบ้าง"
    - If the user says "ราคาเท่าไหร่", you say "How much does it cost?"
  2. Assemble the Conversation Recipe: In Conversation Studio, create a new use case. Select your Bidirectional Translator prompt and leave all other fields blank.