Telepítési útmutatók és sablonok
Ezek az útmutatók segítenek minden szükséges információt előkészíteni, mielőtt konfigurálnád az AI hangügynöködet a Hanc.AI platformon. Ha az üzleti adataid előre rendszerezve vannak, az ügynök beállítása gyorsabb és jobb eredményt ad.
Amikor a platform 24 szerepkör-sablonja közül választasz, a beépített Setup Wizard szakaszról szakaszra végigvezet az üzleti adatok megadásán közvetlenül az alkalmazásban. Az ezen az oldalon található letölthető útmutatók és sablonok kiegészítő forrásként szolgálnak — használd őket az információk offline összegyűjtésére és rendszerezésére, mielőtt a varázslóba beírnád, vagy önálló telepítési dokumentumként, ha inkább manuálisan konfigurálod az ügynököd promptját és tudásbázisát.
A Sablon-szerepkörök oldal minden szerepköre (és a Guided Setup varázsló is) kínál egy „Letöltés Word-dokumentumként" gombot. Ez a letöltés az általad választott szerepkörre és nyelvre van szabva — a kérdések pontosan megfelelnek annak, amit a varázsló az adott szerepkörhöz kérdezne. Miután offline kitöltötted (egyedül vagy a csapatoddal), nyisd meg a Guided Setup varázslót ugyanahhoz a szerepkörhöz, és kattints a Feltöltött dokumentum feltöltése gombra — a varázsló beolvassa a válaszaidat és automatikusan kitölti a megfelelő mezőket, majd áttekinted és folytatod. Az oldalon található statikus sablonok szerepkör-függetlenek, és egy általános, univerzális prompt-struktúrát fednek le — használd, amelyik jobban illik a helyzetedhez.
Két telepítési útvonal létezik:
- A útvonal (tudásbázissal) — a legtöbb vállalkozásnak ajánlott. Az ügynököd promptja a viselkedést definiálja, míg egy különálló tudásbázis-fájl tartalmazza az összes üzleti tényt.
- B útvonal (tudásbázis nélkül) — egyszerű vállalkozásokhoz. Minden (viselkedés + üzleti adatok) egyetlen promptba kerül.
Nem vagy biztos? Kezdj az A útvonallal. Könnyebb frissíteni, amikor az árak, nyitvatartás vagy szolgáltatások változnak, mert csak a tudásbázis-fájlt szerkeszted, nem az egész promptot.
Hogyan válaszd ki az útvonalad
A útvonal: tudásbázissal (ajánlott)
Legjobb: sok szolgáltatású, gyakran változó árú, részletes GYIK-kel, több szakemberrel vagy összetett foglalási folyamattal rendelkező vállalkozásoknak.
Használandó dokumentumok:
- Egyszerű űrlap (01) vagy Munkafüzet (02) — az üzleti információk összegyűjtéséhez
- Tudásbázis sablon (05) — az adatok feltöltésre való strukturálásához
- Univerzális prompt KB-vel (03) — az ügynököd rendszer-promptjaként
B útvonal: tudásbázis nélkül
Legjobb: kevés szolgáltatású, ritkán változó információjú, egyszerű működésű kisvállalkozásoknak.
Használandó dokumentumok:
- Munkafüzet (02) — az üzleti információk összegyűjtéséhez
- Univerzális prompt KB nélkül (04) — minden-egyben prompt közvetlenül beágyazott üzleti adatokkal
Ha a vállalkozásodnak több mint 5 szolgáltatása van, változó árai vagy szezonális akciói, használd inkább az A útvonalat. Egy minden-egyben prompt frissítése minden változáskor hibára hajlamos.
Letölthető útmutatók
Minden dokumentum DOCX-fájlként érhető el. Az eredetik orosz nyelven készültek (európai lokalizáció).
| # | Fájl | Leírás | Letöltés |
|---|---|---|---|
| 00 | Áttekintés | Navigációs útmutató, amely minden dokumentumot és telepítési útvonalat elmagyaráz | Letöltés |
| 01 | Egyszerű űrlap | Gyors, 5 perces kérdőív — ügynök neve, vállalati info, fő szolgáltatások, korlátozások | Letöltés |
| 02 | Munkafüzet | Teljes üzleti munkafüzet — részletes szolgáltatások, szakemberek, foglalási folyamat, GYIK, kommunikációs stílus | Letöltés |
| 03 | Univerzális prompt (KB-vel) | Azonnal használható rendszer-prompt sablon csatlakoztatott tudásbázissal rendelkező ügynököknek | Letöltés |
| 04 | Univerzális prompt (KB nélkül) | Minden-egyben prompt sablon közvetlenül beágyazott üzleti adatokkal | Letöltés |
| 05 | Tudásbázis sablon | Sablon-struktúra a platformra feltöltendő KB-fájlhoz | Letöltés |
| 06 | Gyors indítási útmutató | 15-20 perces gyorsindítási útmutató — regisztrációtól a tesztelésig | Letöltés |
| 07 | Teljes telepítési útmutató | Teljes telepítési útmutató minden haladó modullal (telefónia, naptár, értesítések, API, analitika) | Letöltés |
Univerzális prompt sablon (tudásbázissal)
Ez a 03-as dokumentum legfontosabb tartalmának magyar változata. Használd ezt az ügynököd rendszer-promptjaként, ha csatlakoztatott tudásbázisod van.
Hogyan használd
- Cserélj minden
{{...}}változót a saját értékeidre (a Munkafüzetből vagy az Egyszerű űrlapból) - Másold a teljes prompt-szöveget az Agent Prompt mezőbe a Hanc.AI platformon
- Csatlakoztasd a tudásbázisod (05-ös dokumentum) a Knowledge Base mezőben
Ez a prompt az ügynököd viselkedését definiálja. Minden üzleti tény (szolgáltatások, árak, nyitvatartás, kapcsolat) a csatlakoztatott tudásbázisból származik.
Prompt sablon
# 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.
Cserélendő változók
| Változó | Leírás | Példa |
|---|---|---|
{{AGENT_NAME}} | Az ügynök neve | Anna |
{{COMPANY_NAME}} | Cégnév | Smile Fogászati Klinika |
{{LANGUAGE}} | Kommunikációs nyelv | magyar |
{{GREETING}} | Üdvözlés | „Üdvözlöm! Anna vagyok a Smile Fogászattól. Miben segíthetek?" |
{{FAREWELL}} | Búcsú | „Köszönjük hívását. Szép napot!" |
{{FALLBACK_CONTACT}} | Kihez eszkaláljon | „Mária adminisztrátorunk" |
Univerzális prompt sablon (tudásbázis nélkül)
Ez a 04-es dokumentum legfontosabb tartalmának magyar változata. Akkor használd, ha mindent egyetlen promptban szeretnél, különálló tudásbázis-fájl nélkül.
Mikor használd
- Kisvállalkozás egyszerű szolgáltatáskészlettel
- Gyors indulást szeretnél külön KB-fájl létrehozása nélkül
- Az üzleti információ ritkán változik
Ebben a variánsban MINDEN üzleti információ közvetlenül a promptba van ágyazva. Az ügynök CSAK azt tudja, ami a BUSINESS DATA szakaszban van leírva. Amikor bármi változik, a promptot magát kell szerkesztened.
Hogyan használd
- Töltsd ki a BUSINESS DATA szakaszt (cserélj minden
{{...}}-t) - Cserélj ki az ügynök-változókat (
{{AGENT_NAME}}stb.) - Másold a teljes szöveget az Agent Prompt mezőbe a Hanc.AI platformon
- NE csatlakoztass tudásbázist
Prompt sablon
# 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.
Tudásbázis sablon
Ez a 05-ös dokumentum magyar változata. Töltsd ki az összes szakaszt és töltsd fel a fájlt a platformra.
Mi az a tudásbázis?
A tudásbázis (KB) egy fájl, amely az üzletedről szóló tényeket tartalmazza, és az ügynöködhöz csatlakozik. Az ügynök ebben a fájlban keres, hogy megválaszolja az ügyfél-kérdéseket. Ha az információ nincs ebben a fájlban, az ügynök azt mondja: „Nem tudom."
Hogyan használd
- Töltsd ki az összes alábbi szakaszt (vidd át az adatokat a Munkafüzetből)
- Mentsd a fájlt
.txt,.mdvagy.docxformátumban - Töltsd fel a Hanc.AI-ra: Knowledge Base > Create
- Csatlakoztasd az ügynöködhöz a Model > Knowledge Base menüben
Támogatott feltöltési formátumok: .pdf, .docx, .txt, .md, .html, .csv
Az ügynök CSAK azt tudja, ami ebben a fájlban van. Ha az információ nincs itt, az ügynök nem tud válaszolni. Tartalmazz minden fontos adatot: szolgáltatások, árak, nyitvatartás, cím, kapcsolatok, GYIK.
Sablon
# COMPANY INFORMATION
Company name: [beszúrás]
Company description:
[Írd le, mit csinál a cég, 2-3 mondatban]
What sets us apart from competitors:
[Sorold fel a fő megkülönböztetőket]
# CONTACTS
Address: [teljes cím]
Directions: [tömegközlekedés, tájékozódási pontok, parkolás]
Phone: [szám]
Email: [e-mail]
Website: [url]
Messengers: [WhatsApp, Telegram stb.]
# BUSINESS HOURS
Monday: [órák vagy „zárva"]
Tuesday: [órák]
Wednesday: [órák]
Thursday: [órák]
Friday: [órák]
Saturday: [órák]
Sunday: [órák]
Holidays: [ünnepi menetrend]
# SERVICES AND PRODUCTS
## Service 1
Name: [név]
Description: [mit tartalmaz, kinek szól]
Price: [ár]
Duration: [ha alkalmazható]
## Service 2
Name: [név]
Description: [mit tartalmaz]
Price: [ár]
Duration: [ha alkalmazható]
## Service 3
Name: [név]
Description: [mit tartalmaz]
Price: [ár]
Duration: [ha alkalmazható]
[Add hozzá az összes szolgáltatást ezzel a sablonnal]
# SPECIALISTS / STAFF
[Név 1]
Position: [pozíció]
Specialization: [szakterület]
[Név 2]
Position: [pozíció]
Specialization: [szakterület]
[Töröld ezt a szakaszt, ha nem alkalmazható]
# BOOKING / ORDER PROCESS
[Írd le lépésről lépésre]
Példa:
1. Tisztázd, melyik szolgáltatásra van szükség
2. Kérdezd meg a kívánt dátumot és időpontot
3. Ellenőrizd az elérhetőséget
4. Rögzítsd az ügyfél nevét és telefonszámát
5. Erősítsd meg a foglalást
# CANCELLATION AND RESCHEDULING POLICY
[Írd le a szabályaidat]
Példa:
- Ingyenes lemondás 3+ órával előre
- Lemondás kevesebb mint 3 órán belül — a szolgáltatás 50%-a
- Meg nem jelenés értesítés nélkül — a szolgáltatás 100%-a
# PAYMENT METHODS
[Sorold fel az összes módot]
Példa:
- Készpénz
- Bankkártyák (Visa, MasterCard, Maestro)
- SEPA-átutalás
- Online fizetés a weboldalon
# CURRENT PROMOTIONS AND DISCOUNTS
[Írd le az aktív akciókat]
Példa:
- Első látogatás — 10% kedvezmény
- Születésnap (7 napon belül) — 15% kedvezmény
- Barát ajánlása — 50 EUR kredit
# FREQUENTLY ASKED QUESTIONS (FAQ)
Question: [gyakori kérdés 1]
Answer: [válasz]
Question: [gyakori kérdés 2]
Answer: [válasz]
Question: [gyakori kérdés 3]
Answer: [válasz]
Question: [gyakori kérdés 4]
Answer: [válasz]
Question: [gyakori kérdés 5]
Answer: [válasz]
[Add hozzá az összes gyakran feltett kérdést]
# LIMITATIONS
Agent does NOT discuss: [sorold fel a tiltott témákat]
Agent CANNOT: [sorold fel a tiltott műveleteket]
Hand off to a human when: [sorold fel az eszkalációs helyzeteket]
# ADDITIONAL INFORMATION
[Bármely más információ, amire az ügynöknek szüksége lehet]
Tippek
Kezdj az Egyszerű űrlappal (01) a gyors kezdeti telepítéshez. Amint az ügynököd fut, térj vissza, és töltsd ki a Munkafüzetet (02) egy teljesebb tudásbázishoz. Mindig javíthatsz fokozatosan.
Az ügynök nem tud kitalálni vagy önállóan utánanézni az információnak. Ha egy ügyfél olyasmiről kérdez, ami nincs a tudásbázisban, az ügynök azt fogja mondani, hogy nem tudja. Légy alapos: tartalmazzon minden szolgáltatást, árat, nyitvatartást, szabályzatot és gyakori kérdést.
Minden alkalommal, amikor frissíted a promptot vagy a tudásbázist, futtass egy teszt-beszélgetést. Tedd fel ugyanazokat a kérdéseket, amelyeket egy valódi ügyfél tenne. Ellenőrizd, hogy a válaszok pontosak, és az ügynök nem találja ki az információt.
Amikor árak, nyitvatartás, szolgáltatások vagy akciók változnak, frissítsd a tudásbázis-fájlt és töltsd fel újra. Az elavult információ rosszabb, mint a semmi információ — aláássa az ügyfél bizalmát.
Következő lépések
- Gyors indítás — indítsd el az első ügynököd 15-20 perc alatt
- Az első ügynököd — lépésről lépésre ügynök-létrehozási oktatóanyag
- Tudásbázis — tudj meg többet a tudásbázis-kezelésről
- Sablonok — azonnal használható prompt- és konfiguráció-sablonok
Segítségre van szükséged?
- E-mail: support@hanc.ai