Przejdź do głównej zawartości

Przewodniki konfiguracji i szablony

Te przewodniki pomagają przygotować wszystkie informacje, których potrzebujesz przed skonfigurowaniem swojego agenta głosowego AI na platformie Hanc.AI. Posiadanie danych biznesowych zorganizowanych z wyprzedzeniem przyspiesza konfigurację agenta i daje lepsze wyniki.

Te szablony współpracują z wbudowanym Kreatorem konfiguracji

Gdy tworzysz agenta z jednego z 24 szablonów ról platformy, wbudowany Kreator konfiguracji prowadzi Cię przez wprowadzanie szczegółów biznesowych sekcja po sekcji bezpośrednio w aplikacji. Przewodniki i szablony do pobrania na tej stronie są zasobem uzupełniającym — użyj ich, aby zebrać i zorganizować informacje offline przed wprowadzeniem ich do kreatora, lub jako samodzielnych dokumentów konfiguracji, jeśli wolisz skonfigurować prompt i Bazę wiedzy swojego agenta ręcznie.

Szukasz formularza offline specyficznego dla roli?

Każda rola na stronie Role szablonów (i wewnątrz kreatora Konfiguracji z przewodnikiem) oferuje przycisk „Pobierz jako dokument Word". To pobranie jest dostosowane do konkretnej roli i języka, które wybrałeś — pytania dokładnie pasują do tego, o co kreator by zapytał dla tej roli. Po wypełnieniu offline (samemu lub z zespołem) otwórz kreator Konfiguracji z przewodnikiem dla tej samej roli i kliknij Prześlij wypełniony dokument — kreator czyta Twoje odpowiedzi i automatycznie wypełnia pasujące pola, a następnie przeglądasz i kontynuujesz. Statyczne szablony na tej stronie są niezależne od roli i obejmują ogólną strukturę uniwersalnego promptu — użyj tego, co lepiej pasuje do Twojej sytuacji.

Istnieją dwie ścieżki konfiguracji:

  • Ścieżka A (z Bazą wiedzy) — Zalecana dla większości biznesów. Prompt Twojego agenta definiuje zachowanie, a oddzielny plik Bazy wiedzy zawiera wszystkie fakty biznesowe.
  • Ścieżka B (bez Bazy wiedzy) — Dla prostych biznesów. Wszystko (zachowanie + dane biznesowe) idzie do jednego promptu.
Którą ścieżkę wybrać?

Nie jesteś pewien? Zacznij od Ścieżki A. Jest łatwiejsza do aktualizacji, gdy zmieniają się Twoje ceny, godziny lub usługi, ponieważ edytujesz tylko plik Bazy wiedzy, a nie cały prompt.


Jak wybrać swoją ścieżkę

Ścieżka A: Z Bazą wiedzy (zalecana)

Najlepsza dla: Biznesów z wieloma usługami, często zmieniającymi się cenami, szczegółowym FAQ, wieloma specjalistami lub złożonymi procesami rezerwacji.

Dokumenty do użycia:

  1. Prosty formularz (01) lub Workbook (02) — do zebrania informacji biznesowych
  2. Szablon Bazy wiedzy (05) — do strukturyzacji danych do przesłania
  3. Uniwersalny prompt z KB (03) — jako prompt systemowy Twojego agenta

Ścieżka B: Bez Bazy wiedzy

Najlepsza dla: Małych biznesów z kilkoma usługami, rzadko zmieniającymi się informacjami i prostymi operacjami.

Dokumenty do użycia:

  1. Workbook (02) — do zebrania informacji biznesowych
  2. Uniwersalny prompt bez KB (04) — wszystko-w-jednym prompt z danymi biznesowymi osadzonymi bezpośrednio
Kiedy unikać Ścieżki B

Jeśli Twój biznes ma więcej niż 5 usług, zmieniające się ceny lub sezonowe promocje, użyj Ścieżki A zamiast tego. Aktualizacja wszystko-w-jednym promptu za każdym razem, gdy coś się zmienia, jest podatna na błędy.


Przewodniki do pobrania

Wszystkie dokumenty są dostępne jako pliki DOCX. Oryginały są w języku rosyjskim (europejska lokalizacja).

#PlikOpisPobierz
00PrzeglądPrzewodnik nawigacyjny wyjaśniający wszystkie dokumenty i ścieżki konfiguracjiPobierz
01Prosty formularzSzybki 5-minutowy kwestionariusz — nazwa agenta, info o firmie, główne usługi, ograniczeniaPobierz
02WorkbookKompletny workbook biznesowy — szczegółowe usługi, specjaliści, proces rezerwacji, FAQ, styl komunikacjiPobierz
03Uniwersalny prompt (z KB)Gotowy do użycia szablon systemowego promptu dla agentów z podłączoną Bazą wiedzyPobierz
04Uniwersalny prompt (bez KB)Szablon promptu wszystko-w-jednym z danymi biznesowymi osadzonymi bezpośrednioPobierz
05Szablon Bazy wiedzySzablonowa struktura pliku KB do przesłania na platformęPobierz
06Przewodnik szybkiego startu15-20-minutowy przewodnik szybkiego startu — rejestracja przez testowaniePobierz
07Pełny przewodnik konfiguracjiKompletny przewodnik konfiguracji ze wszystkimi zaawansowanymi modułami (telefonia, kalendarz, powiadomienia, API, analityka)Pobierz

Uniwersalny szablon promptu (z Bazą wiedzy)

To jest angielska wersja kluczowej treści z dokumentu 03. Użyj tego jako systemowego promptu swojego agenta, gdy masz podłączoną Bazę wiedzy.

Jak używać

  1. Zastąp wszystkie zmienne {{...}} własnymi wartościami (z Workbook lub Prostego formularza)
  2. Skopiuj cały tekst promptu do pola Prompt agenta na platformie Hanc.AI
  3. Podłącz swoją Bazę wiedzy (dokument 05) w polu Baza wiedzy
wskazówka

Ten prompt definiuje zachowanie Twojego agenta. Wszystkie fakty biznesowe (usługi, ceny, godziny, kontakty) pochodzą z podłączonej Bazy wiedzy.

Szablon promptu

# 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.

Zmienne do zastąpienia

ZmiennaOpisPrzykład
{{AGENT_NAME}}Imię agentaAnna
{{COMPANY_NAME}}Nazwa firmyKlinika Stomatologiczna Smile
{{LANGUAGE}}Język komunikacjipolski
{{GREETING}}Fraza powitalna„Dzień dobry! Z tej strony Anna ze Smile Dental. W czym mogę pomóc?"
{{FAREWELL}}Fraza pożegnalna„Dziękujemy za telefon. Miłego dnia!"
{{FALLBACK_CONTACT}}Do kogo eskalować„nasza administratorka Maria"

Uniwersalny szablon promptu (bez Bazy wiedzy)

To jest angielska wersja kluczowej treści z dokumentu 04. Użyj tego, gdy chcesz mieć wszystko w jednym prompcie bez oddzielnego pliku Bazy wiedzy.

Kiedy używać

  • Mały biznes z prostym zestawem usług
  • Chcesz szybkiego startu bez tworzenia oddzielnego pliku KB
  • Informacje biznesowe rzadko się zmieniają
ostrzeżenie

W tej wersji WSZYSTKIE informacje biznesowe są osadzone bezpośrednio w prompcie. Agent wie WYŁĄCZNIE to, co jest napisane w sekcji DANYCH BIZNESOWYCH. Gdy cokolwiek się zmienia, musisz edytować sam prompt.

Jak używać

  1. Wypełnij sekcję DANYCH BIZNESOWYCH (zastąp wszystkie {{...}})
  2. Zastąp zmienne agenta ({{AGENT_NAME}} itp.)
  3. Skopiuj cały tekst do pola Prompt agenta na platformie Hanc.AI
  4. NIE podłączaj Bazy wiedzy

Szablon promptu

# 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.

Szablon Bazy wiedzy

To jest angielska wersja dokumentu 05. Wypełnij wszystkie sekcje i prześlij plik na platformę.

Czym jest Baza wiedzy?

Baza wiedzy (KB) to plik zawierający fakty o Twoim biznesie, który zostaje podłączony do Twojego agenta. Agent przeszukuje ten plik, aby odpowiedzieć na pytania klientów. Jeśli informacji nie ma w tym pliku, agent powie „Nie wiem".

Jak używać

  1. Wypełnij wszystkie sekcje poniżej (przenieś dane z Workbook)
  2. Zapisz plik jako .txt, .md lub .docx
  3. Prześlij na Hanc.AI: Baza wiedzy > Utwórz
  4. Podłącz do swojego agenta w Model > Baza wiedzy

Obsługiwane formaty przesyłania: .pdf, .docx, .txt, .md, .html, .csv

ostrzeżenie

Agent wie WYŁĄCZNIE to, co jest w tym pliku. Jeśli informacji tutaj nie ma, agent nie może odpowiedzieć. Uwzględnij wszystkie ważne dane: usługi, ceny, godziny pracy, adres, kontakty, FAQ.

Szablon

# 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]

Wskazówki

Zacznij prosto, potem rozszerzaj

Zacznij od Prostego formularza (01) dla szybkiej początkowej konfiguracji. Gdy Twój agent już działa, wróć i wypełnij Workbook (02) dla bardziej kompletnej Bazy wiedzy. Zawsze możesz poprawiać przyrostowo.

Twój agent wie tylko to, co dostarczysz

Agent nie może zgadywać ani sam wyszukiwać informacji. Jeśli klient zapyta o coś, czego nie ma w Bazie wiedzy, agent powie, że nie wie. Bądź dokładny: uwzględnij wszystkie usługi, ceny, godziny, zasady i częste pytania.

Testuj po każdej zmianie

Za każdym razem, gdy aktualizujesz prompt lub Bazę wiedzy, przeprowadź testową rozmowę. Zadaj te same pytania, które zadałby prawdziwy klient. Sprawdź, czy odpowiedzi są dokładne i czy agent nie wymyśla informacji.

Utrzymuj swoją Bazę wiedzy aktualną

Gdy ceny, godziny pracy, usługi lub promocje się zmieniają, zaktualizuj plik Bazy wiedzy i prześlij go ponownie. Przestarzała informacja jest gorsza niż brak informacji — niszczy zaufanie klienta.


Następne kroki


Potrzebujesz pomocy?