Гиды и шаблоны настройки

Эти гиды помогают подготовить всю информацию перед настройкой голосового агента на платформе Hanc.AI. Если бизнес-данные организованы заранее, настройка идёт быстрее и даёт лучшие результаты.

Эти шаблоны работают вместе со встроенным Setup Wizard

Когда вы создаёте агента из одного из 24 шаблонов ролей, встроенный Setup Wizard проводит вас по заполнению бизнес-деталей по разделам прямо в приложении. Скачиваемые гиды и шаблоны на этой странице — дополнительный ресурс: используйте их, чтобы собрать и организовать информацию оффлайн до ввода в мастер, или как самостоятельные документы настройки, если предпочитаете настраивать промпт и базу знаний агента вручную.

Ищете оффлайн-форму под конкретную роль?

Каждая роль на странице Template Roles (и внутри Guided Setup wizard) предлагает кнопку «Download as Word document». Эта загрузка подстроена под конкретную выбранную роль и язык — вопросы точно совпадают с тем, что спросит мастер. После заполнения оффлайн (одному или с командой) откройте Guided Setup мастер для той же роли и нажмите Upload filled document — мастер прочтёт ответы и автозаполнит совпадающие поля, затем вы проверяете и продолжаете. Статические шаблоны на этой странице — роле-нейтральные и покрывают универсальную структуру промпта — используйте то, что подходит вашей ситуации.

Два пути настройки:

Путь A (с базой знаний) — рекомендуется большинству. Промпт агента определяет поведение, отдельный файл базы знаний содержит все бизнес-факты.
Путь B (без базы знаний) — для простых бизнесов. Всё (поведение + бизнес-данные) идёт в один промпт.

Какой путь выбрать?

Не уверены? Начните с Пути A. Его проще обновлять при изменении цен, часов или услуг — вы правите только файл базы знаний, а не весь промпт.

Как выбрать путь

Путь A: с базой знаний (рекомендуется)

Лучше всего для: бизнесов с множеством услуг, часто меняющимися ценами, подробным FAQ, несколькими специалистами или сложным процессом записи.

Документы:

Simple Form (01) или Workbook (02) — собрать бизнес-информацию
Knowledge Base Template (05) — структурировать данные для загрузки
Universal Prompt with KB (03) — как системный промпт агента

Путь B: без базы знаний

Лучше всего для: малого бизнеса с малым числом услуг, редко меняющейся информацией и простыми операциями.

Документы:

Workbook (02) — собрать бизнес-информацию
Universal Prompt without KB (04) — all-in-one промпт с бизнес-данными внутри

Когда избегать Пути B

Если в бизнесе больше 5 услуг, меняющиеся цены или сезонные акции — используйте Путь A. Править all-in-one промпт каждый раз — ошибочно.

Скачиваемые гиды

Все документы доступны в формате DOCX. Оригиналы на русском (европейская локализация).

#	Файл	Описание	Скачать
00	Обзор	Навигационный гид, объясняющий все документы и пути настройки	Скачать
01	Simple Form	Быстрая 5-минутная анкета — имя агента, инфо компании, ключевые услуги, ограничения	Скачать
02	Workbook	Полная рабочая тетрадь — детальные услуги, специалисты, процесс записи, FAQ, стиль общения	Скачать
03	Universal Prompt (with KB)	Готовый шаблон системного промпта для агентов с базой знаний	Скачать
04	Universal Prompt (without KB)	All-in-one шаблон промпта с бизнес-данными внутри	Скачать
05	Knowledge Base Template	Шаблон структуры файла БЗ для загрузки на платформу	Скачать
06	Quick Start Guide	15–20-минутный гид быстрого запуска — от регистрации до тестирования	Скачать
07	Full Setup Guide	Полный гид настройки со всеми продвинутыми модулями (телефония, календарь, уведомления, API, аналитика)	Скачать

Universal Prompt Template (с базой знаний)

Это английская версия ключевого контента из документа 03. Используйте как системный промпт агента, если подключена база знаний.

Как использовать

Замените все переменные {{...}} на свои значения (из Workbook или Simple Form)
Скопируйте весь текст в поле Agent Prompt в Hanc.AI
Подключите вашу базу знаний (документ 05) в поле Knowledge Base

подсказка

Этот промпт определяет поведение агента. Все бизнес-факты (услуги, цены, часы, контакты) идут из подключённой базы знаний.

Шаблон промпта

# 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
`{{LANGUAGE}}`	Язык общения	Русский
`{{GREETING}}`	Приветствие	«Здравствуйте! Это Анна из Smile Dental. Чем могу помочь?»
`{{FAREWELL}}`	Прощание	«Спасибо за звонок. Хорошего дня!»
`{{FALLBACK_CONTACT}}`	Кому передавать	«нашему администратору Марии»

Universal Prompt Template (без базы знаний)

Это английская версия ключевого контента из документа 04. Используйте, если хотите всё в одном промпте без отдельного файла базы знаний.

Когда использовать

Малый бизнес с простым набором услуг
Нужен быстрый запуск без создания отдельного файла БЗ
Бизнес-информация редко меняется

внимание

В этом варианте ВСЯ бизнес-информация встроена прямо в промпт. Агент знает ТОЛЬКО то, что в разделе BUSINESS DATA. При любом изменении придётся редактировать сам промпт.

Как использовать

Заполните раздел BUSINESS DATA (замените все {{...}})
Замените переменные агента ({{AGENT_NAME}} и т. д.)
Скопируйте весь текст в поле Agent Prompt в Hanc.AI
НЕ подключайте базу знаний

Шаблон промпта

# 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. Заполните все разделы и загрузите файл на платформу.

Что такое база знаний?

База знаний (БЗ) — это файл с фактами о вашем бизнесе, подключаемый к агенту. Агент ищет в этом файле, отвечая на вопросы. Если информации в файле нет — агент скажет «Не знаю».

Как использовать

Заполните все разделы ниже (перенесите данные из Workbook)
Сохраните файл как .txt, .md или .docx
Загрузите на Hanc.AI: Knowledge Base > Create
Подключите к агенту в Model > Knowledge Base

Поддерживаемые форматы: .pdf, .docx, .txt, .md, .html, .csv

внимание

Агент знает ТОЛЬКО то, что в этом файле. Если информации здесь нет — агент не сможет ответить. Включайте все важные данные: услуги, цены, часы, адрес, контакты, FAQ.

Шаблон

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

Советы

Начинайте просто, потом расширяйте

Начните с Simple Form (01) для быстрой первичной настройки. Когда агент уже работает — вернитесь и заполните Workbook (02) для более полной базы знаний. Можно улучшать постепенно.

Агент знает только то, что вы дали

Агент не угадывает и не ищет информацию сам. Если клиент спросит о том, чего нет в базе знаний — агент скажет, что не знает. Будьте основательны: включайте все услуги, цены, часы, политики и частые вопросы.

Тестируйте после каждого изменения

После каждого обновления промпта или базы знаний проведите тестовый разговор. Задавайте те же вопросы, что реальный клиент. Проверяйте, что ответы корректны и агент не выдумывает.

Держите базу знаний в актуальном состоянии

Когда меняются цены, часы, услуги или акции — обновляйте файл базы и перезаливайте. Устаревшая информация хуже её отсутствия — она разрушает доверие.

Следующие шаги

Быстрый старт — запустите первого агента за 15–20 минут
Ваш первый агент — пошаговый туториал создания агента
База знаний — узнайте больше про управление базой знаний
Шаблоны — готовые шаблоны промптов и конфигураций

Нужна помощь?

Email: support@hanc.ai

Как выбрать путь​

Путь A: с базой знаний (рекомендуется)​

Путь B: без базы знаний​

Скачиваемые гиды​

Universal Prompt Template (с базой знаний)​

Как использовать​

Шаблон промпта​

Переменные для замены​

Universal Prompt Template (без базы знаний)​

Когда использовать​

Как использовать​

Шаблон промпта​

Шаблон базы знаний​

Что такое база знаний?​

Как использовать​

Шаблон​

Советы​

Следующие шаги​

Нужна помощь?​

Как выбрать путь

Путь A: с базой знаний (рекомендуется)

Путь B: без базы знаний

Скачиваемые гиды

Universal Prompt Template (с базой знаний)

Как использовать

Шаблон промпта

Переменные для замены

Universal Prompt Template (без базы знаний)

Когда использовать

Как использовать

Шаблон промпта

Шаблон базы знаний

Что такое база знаний?

Как использовать

Шаблон

Советы

Следующие шаги

Нужна помощь?