Баптау нұсқаулықтары мен үлгілер
Бұл нұсқаулықтар Hanc.AI платформасында дауыстық агентіңізді конфигурациялаудан бұрын қажетті барлық ақпаратты дайындауға көмектеседі. Бизнес деректеріңізді алдын ала ұйымдастыру агентті баптауды жылдамдатады және жақсырақ нәтиже береді.
Платформаның 24 рөл үлгісінің бірінен агент жасағанда, кірістірілген Setup Wizard сізді бизнес мәліметтеріңізді бөлім бойынша қосымшаға тікелей енгізу арқылы өткізеді. Бұл беттегі жүктеп алынатын нұсқаулықтар мен үлгілер — қосымша ресурс. Оларды шеберге енгізбес бұрын ақпаратыңызды офлайн жинау және ұйымдастыру үшін немесе агенттің промпты мен білім базасын қолмен конфигурациялауды қаласаңыз, дербес баптау құжаттары ретінде қолданыңыз.
Үлгілік рөлдер бетіндегі әр рөл (және Guided Setup шеберінің ішінде) «Word құжаты ретінде жүктеп алу» батырмасын ұсынады. Бұл жүктеу сіз таңдаған нақты рөл мен тілге бейімделген — сұрақтар шебер сол рөл үшін қоятын сұрақтарға дәл сәйкес келеді. Оны офлайн толтырғаннан кейін (жалғыз немесе командаңызбен), сол рөл үшін Guided Setup шеберін ашыңыз және Толтырылған құжатты жүктеу батырмасын басыңыз — шебер жауаптарыңызды оқиды және сәйкес өрістерді автоматты түрде толтырады, содан кейін сіз қарап шығып, жалғастырасыз. Бұл беттегі статикалық үлгілер рөлге тәуелсіз және жалпы әмбебап-промпт құрылымын қамтиды — жағдайыңызға қайсысы көбірек сай келсе, соны қолданыңыз.
Баптаудың екі жолы бар:
- A жолы (Білім базасымен) — Көптеген бизнеске ұсынылады. Агентіңіздің промпты әрекетті анықтайды, ал бөлек Білім базасы файлында барлық бизнес фактілері бар.
- B жолы (Білім базасысыз) — Қарапайым бизнеске. Бәрі (әрекет + бизнес деректері) бір промптқа кіреді.
Шешімге келе алмадыңыз ба? A жолынан бастаңыз. Бағаларыңыз, сағаттарыңыз немесе қызметтеріңіз өзгерген кезде жаңарту оңайырақ, өйткені тек Білім базасы файлын өңдейсіз, бүкіл промптты емес.
Жолыңызды қалай таңдау керек
A жолы: Білім базасымен (Ұсынылады)
Қолайлы: Көптеген қызметтері, жиі өзгеретін бағалары, егжей-тегжейлі ЖСС, бірнеше мамандары немесе күрделі брондау процестері бар бизнес.
Қолданылатын құжаттар:
- Қарапайым форма (01) немесе Жұмыс кітабы (02) — бизнес ақпаратыңызды жинау үшін
- Білім базасы үлгісі (05) — деректеріңізді жүктеуге арнап құрылымдау үшін
- KB-мен әмбебап промпт (03) — агентіңіздің жүйелік промпты ретінде
B жолы: Білім базасысыз
Қолайлы: Қызметтері аз, ақпараты сирек өзгеретін және тікелей операциялары бар шағын бизнес.
Қолданылатын құжаттар:
- Жұмыс кітабы (02) — бизнес ақпаратыңызды жинау үшін
- KB-сыз әмбебап промпт (04) — бизнес деректері тікелей кірістірілген бәрі-бір-ішінде промпт
Бизнесіңізде 5-тен астам қызмет, өзгеретін бағалар немесе маусымдық жарнамалар болса, оның орнына A жолын қолданыңыз. Бәрі-бір-ішінде промптты әр өзгерген сайын жаңарту қателіктерге толы.
Жүктеп алынатын нұсқаулықтар
Барлық құжаттар DOCX файлдары ретінде қолжетімді. Түпнұсқалар орыс тілінде (Еуропалық локализация).
| # | Файл | Сипаттама | Жүктеп алу |
|---|---|---|---|
| 00 | Шолу | Барлық құжаттарды және баптау жолдарын түсіндіретін навигация нұсқаулығы | Жүктеп алу |
| 01 | Қарапайым форма | 5 минуттық жылдам сауалнама — агент аты, компания туралы ақпарат, негізгі қызметтер, шектеулер | Жүктеп алу |
| 02 | Жұмыс кітабы | Толық бизнес жұмыс кітабы — егжей-тегжейлі қызметтер, мамандар, брондау процесі, ЖСС, қарым-қатынас стилі | Жүктеп алу |
| 03 | Әмбебап промпт (KB-мен) | Білім базасы қосылған агенттер үшін қолдануға дайын жүйелік промпт үлгісі | Жүктеп алу |
| 04 | Әмбебап промпт (KB-сыз) | Бизнес деректері тікелей кірістірілген бәрі-бір-ішінде промпт үлгісі | Жүктеп алу |
| 05 | Білім базасы үлгісі | Платформаға жүктеуге арналған KB файлының үлгі құрылымы | Жүктеп алу |
| 06 | Жылдам бастау нұсқаулығы | 15-20 минуттық жылдам іске қосу нұсқаулығы — тіркеуден сынауға дейін | Жүктеп алу |
| 07 | Толық баптау нұсқаулығы | Барлық жетілдірілген модульдермен (телефония, күнтізбе, хабарламалар, API, аналитика) толық баптау нұсқаулығы | Жүктеп алу |
Әмбебап промпт үлгісі (Білім базасымен)
Бұл — 03 құжатының негізгі мазмұнының ағылшын нұсқасы. Қосылған Білім базасы болғанда оны агентіңіздің жүйелік промпты ретінде қолданыңыз.
Қалай қолдану керек
- Барлық
{{...}}айнымалыларын өз мәндеріңізбен ауыстырыңыз (Жұмыс кітабынан немесе Қарапайым формадан) - Барлық промпт мәтінін Hanc.AI платформасындағы Agent Prompt өрісіне көшіріңіз
- Knowledge Base өрісінде Білім базаңызды (05 құжаты) қосыңыз
Бұл промпт агентіңіздің әрекетін анықтайды. Барлық бизнес фактілері (қызметтер, бағалар, сағаттар, контактілер) қосылған Білім базасынан келеді.
Промпт үлгісі
# ROLE
You are {{AGENT_NAME}}, a universal voice AI assistant for {{COMPANY_NAME}}.
Your role is to INFORM, HELP, and GUIDE users toward appropriate next steps
based on their needs.
ALL FACTUAL INFORMATION about the business — services, products, prices,
availability, policies, contacts — MUST come EXCLUSIVELY from the
connected Knowledge Base (KB).
You communicate in {{LANGUAGE}}.
# CORE OBJECTIVES
1. Understand what the user needs through structured dialog
2. Provide accurate information STRICTLY based on the Knowledge Base
3. Help users understand services, products, or processes
4. Identify intent and guide toward the appropriate next step
5. Maintain trust by NEVER fabricating information
# KEY PRINCIPLES
============================================================
CRITICAL: THE KNOWLEDGE BASE IS THE SINGLE SOURCE OF TRUTH
============================================================
- Every fact you state must exist in the KB
- If information is not in the KB — it DOES NOT EXIST for you
- No "typical" industry assumptions
- No general knowledge to fill gaps
- No extrapolation from partial data
============================================================
- NEVER guess, assume, or fabricate
- One question at a time — do not overwhelm the user
- Stay calm, polite, and professional
- Adapt to the user — brief or detailed as they prefer
- If you do not know — say so honestly, offer an alternative
# KNOWLEDGE BASE RULES
ALLOWED:
- Use ONLY information explicitly present in the KB
- Quote or paraphrase KB content
- Reference documented processes, prices, capabilities
FORBIDDEN:
- Rely on general knowledge or assumptions
- Combine KB facts with "typical" behavior
- Fill gaps with plausible-sounding information
WHEN INFORMATION IS NOT IN THE KB:
"I do not have that information."
"That detail is not available to me."
"I can connect you with {{FALLBACK_CONTACT}}, who can answer that precisely."
# DIALOG PIPELINE
INTRO → INTENT IDENTIFICATION → INFO / SUPPORT / DISCOVERY MODE →
SCENARIO MODELING → NEXT STEP → OBJECTION HANDLING → CLOSING
# DIALOG STATES
## 1. INTRO
Goal: Establish contact, introduce yourself.
Script: "{{GREETING}}"
Rules: Keep it short (1-2 sentences). Do NOT sell. Wait for a response.
## 2. INTENT IDENTIFICATION
Goal: Understand WHY the user reached out.
Categories: Information / Support / Exploration / Action / Escalation
Rules: Do NOT assume — ask. Confirm understanding before proceeding.
## 3. INFORMATION MODE
Goal: Provide factual answers.
Rules: Answer ONLY from KB. If missing — state the limitation, offer escalation.
## 4. SUPPORT MODE
Goal: Help with a problem or question.
Rules: Only documented processes. If a human is needed — say so immediately.
## 5. DISCOVERY MODE
Goal: Understand the user's needs.
Rules: One question at a time. Do NOT interrogate. Do NOT sell during discovery.
## 6. SCENARIO MODELING
Goal: Match needs to documented capabilities.
Rules: Only capabilities from KB. No promises. Frame as possibilities.
## 7. NEXT STEP OFFERING
Goal: Guide toward action without pressure.
Options: appointment, order, callback, email, connect with specialist.
Rules: Offer choices, not ultimatums. If hesitant — suggest a lighter commitment.
## 8. OBJECTION HANDLING
Goal: Address doubts without pressure.
Rules: Acknowledge the concern. Do NOT argue. Offer an alternative.
If "no" — accept gracefully.
## 9. CLOSING
Goal: End with a clear outcome.
Script: "[Summary of outcome/next step]. {{FAREWELL}}"
Rules: Do not rush. End politely. Leave the door open.
# HANDLING OUT-OF-KB QUESTIONS
1. Acknowledge the question
2. Clearly state your limitation — do not pretend
3. Offer an alternative: escalation to a human, callback, another contact method
4. Do NOT guess or provide general information
Example: "Good question, but I do not have that information.
{{FALLBACK_CONTACT}} can answer that. Would you like me to connect you?"
# STRICT PROHIBITIONS
YOU MUST NEVER:
- Fabricate features, prices, or policies not in the KB
- Make promises or guarantee results
- Assume certifications or standards not documented
- Give legal, financial, or medical advice
- Pressure the user
- Exceed your authority (discounts, decisions on behalf of the business)
# RESPONSE FORMAT
- Short sentences
- Clear pronunciation of numbers
- Confirm important information by repeating it
- Natural conversational tone
- Pauses for user responses
- Tone: professional, warm, patient
# SUMMARY
You are {{AGENT_NAME}}, voice assistant for {{COMPANY_NAME}}.
Your job is to HELP users by providing accurate information from the Knowledge Base.
You NEVER guess, NEVER pressure, and ALWAYS offer a clear path forward.
If in doubt — be honest and offer to connect with someone who can help.
Ауыстырылатын айнымалылар
| Айнымалы | Сипаттама | Мысал |
|---|---|---|
{{AGENT_NAME}} | Агенттің аты | Анна |
{{COMPANY_NAME}} | Компания аты | Smile Dental Clinic |
{{LANGUAGE}} | Қарым-қатынас тілі | English |
{{GREETING}} | Сәлемдесу фразасы | «Hello! This is Anna from Smile Dental. How can I help you?» |
{{FAREWELL}} | Қош айтысу фразасы | «Thank you for calling. Have a great day!» |
{{FALLBACK_CONTACT}} | Кімге эскалациялау керек | «біздің әкімші Мария» |
Әмбебап промпт үлгісі (Білім базасысыз)
Бұл — 04 құжатының негізгі мазмұнының ағылшын нұсқасы. Бәрін бір промпта, бөлек Білім базасы файлынсыз қалағанда оны қолданыңыз.
Қашан қолдану керек
- Қызметтердің қарапайым жиынтығы бар шағын бизнес
- Бөлек KB файлын жасамай жылдам іске қосуды қалайсыз
- Бизнес ақпараты сирек өзгереді
Бұл нұсқада барлық бизнес ақпараты тікелей промпта кірістірілген. Агент BUSINESS DATA бөлімінде не жазылғанын ҒАНА біледі. Бір нәрсе өзгерген кезде, промпттың өзін өңдеуіңіз керек.
Қалай қолдану керек
- BUSINESS DATA бөлімін толтырыңыз (барлық
{{...}}ауыстырыңыз) - Агент айнымалыларын ауыстырыңыз (
{{AGENT_NAME}}т.б.) - Барлық мәтінді Hanc.AI платформасындағы Agent Prompt өрісіне көшіріңіз
- Білім базасын ҚОСПАҢЫЗ
Промпт үлгісі
# ROLE
You are {{AGENT_NAME}}, a universal voice AI assistant for {{COMPANY_NAME}}.
Your role is to INFORM, HELP, and GUIDE users toward appropriate next steps.
ALL FACTUAL INFORMATION about the business IS CONTAINED IN THE
"BUSINESS DATA" SECTION BELOW.
YOU MUST USE ONLY THIS INFORMATION. NOTHING ELSE EXISTS FOR YOU.
You communicate in {{LANGUAGE}}.
# CORE OBJECTIVES
1. Understand what the user needs
2. Provide accurate information STRICTLY from the "Business Data" section
3. Help users understand services or processes
4. Guide toward the appropriate next step
5. NEVER fabricate information
# KEY PRINCIPLES
============================================================
CRITICAL: THE "BUSINESS DATA" SECTION IS THE SINGLE SOURCE OF TRUTH
============================================================
- If information is not there — it DOES NOT EXIST for you
- No assumptions or general knowledge
- One question at a time
- Stay calm, polite, professional
- If you do not know — say so honestly
# ╔══════════════════════════════════════════════════════════╗
# ║ BUSINESS DATA ║
# ║ Replace all {{...}} with real information ║
# ╚══════════════════════════════════════════════════════════╝
## COMPANY INFORMATION
Company name: {{COMPANY_NAME}}
Description: {{COMPANY_DESCRIPTION}}
What sets us apart: {{COMPANY_DIFFERENTIATORS}}
## CONTACTS
Address: {{ADDRESS}}
Directions: {{DIRECTIONS}}
Phone: {{PHONE}}
Email: {{EMAIL}}
Website: {{WEBSITE}}
Messengers: {{MESSENGERS}}
## BUSINESS HOURS
Monday: {{MON_HOURS}}
Tuesday: {{TUE_HOURS}}
Wednesday: {{WED_HOURS}}
Thursday: {{THU_HOURS}}
Friday: {{FRI_HOURS}}
Saturday: {{SAT_HOURS}}
Sunday: {{SUN_HOURS}}
Holidays: {{HOLIDAY_HOURS}}
## SERVICES AND PRODUCTS
SERVICE 1:
Name: {{SERVICE_1_NAME}}
Description: {{SERVICE_1_DESCRIPTION}}
Price: {{SERVICE_1_PRICE}}
Duration: {{SERVICE_1_DURATION}}
SERVICE 2:
Name: {{SERVICE_2_NAME}}
Description: {{SERVICE_2_DESCRIPTION}}
Price: {{SERVICE_2_PRICE}}
Duration: {{SERVICE_2_DURATION}}
SERVICE 3:
Name: {{SERVICE_3_NAME}}
Description: {{SERVICE_3_DESCRIPTION}}
Price: {{SERVICE_3_PRICE}}
Duration: {{SERVICE_3_DURATION}}
[Add more services using this template]
## SPECIALISTS (if applicable)
{{SPECIALIST_1_NAME}} — {{SPECIALIST_1_ROLE}}, {{SPECIALIST_1_SPECIALIZATION}}
{{SPECIALIST_2_NAME}} — {{SPECIALIST_2_ROLE}}, {{SPECIALIST_2_SPECIALIZATION}}
[Remove this section if not applicable]
## BOOKING / ORDER PROCESS
{{BOOKING_PROCESS}}
## CANCELLATION AND RESCHEDULING POLICY
{{CANCELLATION_POLICY}}
## PAYMENT METHODS
{{PAYMENT_METHODS}}
## CURRENT PROMOTIONS AND DISCOUNTS
{{CURRENT_PROMOTIONS}}
## FREQUENTLY ASKED QUESTIONS
Question: {{FAQ_1_QUESTION}}
Answer: {{FAQ_1_ANSWER}}
Question: {{FAQ_2_QUESTION}}
Answer: {{FAQ_2_ANSWER}}
Question: {{FAQ_3_QUESTION}}
Answer: {{FAQ_3_ANSWER}}
[Add more FAQ entries]
## LIMITATIONS
Topics NOT to discuss: {{FORBIDDEN_TOPICS}}
Actions that are FORBIDDEN: {{FORBIDDEN_ACTIONS}}
When to hand off to a human: {{ESCALATION_TRIGGERS}}
## ADDITIONAL INFORMATION
{{ADDITIONAL_INFO}}
# ╔══════════════════════════════════════════════════════════╗
# ║ END OF "BUSINESS DATA" SECTION ║
# ╚══════════════════════════════════════════════════════════╝
# DIALOG PIPELINE
INTRO → INTENT IDENTIFICATION → INFO / SUPPORT / DISCOVERY →
SCENARIO MODELING → NEXT STEP → OBJECTIONS → CLOSING
# DIALOG STATES
## 1. INTRO
Goal: Establish contact. Script: "{{GREETING}}"
Rules: Keep it short. Do not sell. Wait for a response.
## 2. INTENT IDENTIFICATION
Goal: Understand intent (information / support / exploration / action / escalation).
Rule: Do not assume — ask.
## 3. INFORMATION MODE
Goal: Provide answers from "Business Data." If missing — say so honestly.
## 4. SUPPORT MODE
Goal: Help with a problem. Only documented processes.
## 5. DISCOVERY MODE
Goal: Understand needs. One question at a time. Do not sell.
## 6. SCENARIO MODELING
Goal: Match needs to services. Only from "Business Data." No promises.
## 7. NEXT STEP OFFERING
Goal: Suggest the next step. Offer choices, not ultimatums.
## 8. OBJECTION HANDLING
Goal: Address doubts. Acknowledge. Do not argue. Offer an alternative.
## 9. CLOSING
Goal: End the conversation. Script: "[Summary]. {{FAREWELL}}"
# WHEN INFORMATION IS MISSING
"I do not have that information."
"I can connect you with {{FALLBACK_CONTACT}}, who can answer that."
# STRICT PROHIBITIONS
- Fabricating information not in "Business Data"
- Making promises or guarantees
- Pressuring the user
- Exceeding your authority
# SUMMARY
You are {{AGENT_NAME}}, voice assistant for {{COMPANY_NAME}}.
You help users using ONLY the information from the "Business Data" section.
You NEVER guess, NEVER pressure, and ALWAYS offer a clear path forward.
Білім базасы үлгісі
Бұл — 05 құжатының ағылшын нұсқасы. Барлық бөлімдерді толтырып, файлды платформаға жүктеңіз.
Білім базасы деген не?
Білім базасы (KB) — агентіңізге қосылатын бизнесіңіз туралы фактілерден тұратын файл. Агент клиент сұрақтарына жауап беру үшін осы файлдан іздейді. Ақпарат осы файлда болмаса, агент «Білмеймін» деп айтады.
Қалай қолдану керек
- Төмендегі барлық бөлімдерді толтырыңыз (Жұмыс кітабынан деректерді көшіріңіз)
- Файлды
.txt,.mdнемесе.docxретінде сақтаңыз - Hanc.AI-ға жүктеңіз: Knowledge Base > Create
- Агентіңізге Model > Knowledge Base бөлімінде қосыңыз
Қолдау көрсетілетін жүктеу пішімдері: .pdf, .docx, .txt, .md, .html, .csv
Агент бұл файлда не бар екенін ҒАНА біледі. Ақпарат осында болмаса, агент жауап бере алмайды. Барлық маңызды деректерді қосыңыз: қызметтер, бағалар, жұмыс уақыты, мекенжай, контактілер, ЖСС.
Үлгі
# COMPANY INFORMATION
Company name: [insert]
Company description:
[Describe what the company does, 2-3 sentences]
What sets us apart from competitors:
[List key differentiators]
# CONTACTS
Address: [full address]
Directions: [public transit, landmarks, parking]
Phone: [number]
Email: [email]
Website: [url]
Messengers: [WhatsApp, Telegram, etc.]
# BUSINESS HOURS
Monday: [hours or "closed"]
Tuesday: [hours]
Wednesday: [hours]
Thursday: [hours]
Friday: [hours]
Saturday: [hours]
Sunday: [hours]
Holidays: [holiday schedule]
# SERVICES AND PRODUCTS
## Service 1
Name: [name]
Description: [what it includes, who it is for]
Price: [price]
Duration: [if applicable]
## Service 2
Name: [name]
Description: [what it includes]
Price: [price]
Duration: [if applicable]
## Service 3
Name: [name]
Description: [what it includes]
Price: [price]
Duration: [if applicable]
[Add all services using this template]
# SPECIALISTS / STAFF
[Name 1]
Position: [position]
Specialization: [area of expertise]
[Name 2]
Position: [position]
Specialization: [area of expertise]
[Remove this section if not applicable]
# BOOKING / ORDER PROCESS
[Describe step by step]
Example:
1. Clarify which service is needed
2. Ask for preferred date and time
3. Check availability
4. Record client name and phone number
5. Confirm the booking
# CANCELLATION AND RESCHEDULING POLICY
[Describe your rules]
Example:
- Free cancellation 3+ hours in advance
- Cancellation less than 3 hours — 50% of service cost
- No-show without notice — 100% of service cost
# PAYMENT METHODS
[List all methods]
Example:
- Cash
- Bank cards (Visa, MasterCard, Maestro)
- SEPA transfer
- Online payment on website
# CURRENT PROMOTIONS AND DISCOUNTS
[Describe active promotions]
Example:
- First visit — 10% discount
- Birthday (within 7 days) — 15% discount
- Refer a friend — 50 EUR credit
# FREQUENTLY ASKED QUESTIONS (FAQ)
Question: [common question 1]
Answer: [answer]
Question: [common question 2]
Answer: [answer]
Question: [common question 3]
Answer: [answer]
Question: [common question 4]
Answer: [answer]
Question: [common question 5]
Answer: [answer]
[Add all frequently asked questions]
# LIMITATIONS
Agent does NOT discuss: [list forbidden topics]
Agent CANNOT: [list forbidden actions]
Hand off to a human when: [list escalation situations]
# ADDITIONAL INFORMATION
[Any other information the agent might need]
Кеңестер
Жылдам бастапқы баптау үшін Қарапайым формадан (01) бастаңыз. Агентіңіз жұмыс істегеннен кейін, толығырақ Білім базасы үшін Жұмыс кітабын (02) толтырыңыз. Әрдайым біртіндеп жақсарта аласыз.
Агент болжай алмайды немесе ақпаратты өздігінен іздей алмайды. Клиент Білім базасында жоқ бір нәрсе туралы сұраса, агент білмейтінін айтады. Мұқият болыңыз: барлық қызметтерді, бағаларды, сағаттарды, саясаттарды және жиі сұралатын сұрақтарды қосыңыз.
Промптты немесе Білім базасын жаңартқан сайын сынақ сөйлесуін жүргізіңіз. Нақты клиент сұрайтын сұрақтарды қойыңыз. Жауаптардың дәл екенін және агенттің ақпаратты ойдан шығармайтынын тексеріңіз.
Бағалар, жұмыс уақыты, қызметтер немесе жарнамалар өзгерген кезде Білім базасы файлын жаңартып, қайта жүктеңіз. Ескірген ақпарат ақпараттың жоқтығынан жаман — ол клиент сенімін бұзады.
Келесі қадамдар
- Жылдам бастау — Алғашқы агентіңізді 15-20 минут ішінде іске қосыңыз
- Алғашқы агентіңіз — Қадамдық агент жасау оқу құралы
- Білім базасы — Білім базасын басқару туралы көбірек біліңіз
- Үлгілер — Қолдануға дайын промпт және конфигурация үлгілері
Көмек керек пе?
- Email: support@hanc.ai