Skip to main content
Персонализираните Mid-Call Tools позволяват на вашия AI асистент да взаимодейства с външни системи по време на разговори. Било то проверка на наличности, верификация на клиентски данни или извличане на информация в реalno време, тези инструменти правят вашия AI по-мощен и свързан.

​
Преглед

Персонализираните Mid-Call Tools позволяват на вашия AI асистент да:
  • Прави API повиквания в реално време по време на разговори
  • Извлича или подава данни към вашите системи
  • Взима информирани решения на база актуални данни
  • Предоставя точна, актуална информация на обаждащите се

Ключови предимства

  • Не се изисква програмиране - просто конфигурирайте API endpoint-а и параметрите - AI автоматично знае кога и как да използва инструментите - Достъп до данни в реално време по време на разговори - Безпроблемна интеграция с вашите съществуващи системи

​
Настройване на вашия инструмент

​
1. Основна конфигурация

Main Tool Configuration
1

Достъп до създаването на инструмент

Отидете на Mid call tools и кликнете Create Mid-Call Tool
2

Конфигурирайте основните настройки

Попълнете основните детайли:
  • Name: Използвайте малки букви и долни черти (например, check_order_status)
  • Description: Обяснете кога и как AI трябва да използва този инструмент
  • Endpoint: Вашия API URL (например, https://api.yourcompany.com/orders)
  • Timeout: Колко време да се чака за отговори (в секунди)
  • Method: Изберете GET, POST, PUT, PATCH или DELETE
3

Добавете headers

Често използвани headers, които може да се нуждаете:
Content-Type: application/json
Authorization: Bearer your_token

​
2. Конфигурация на променливи

Variable Configuration
1

Дефинирайте параметри

Това са частите от информацията, които вашият AI ще събира по време на разговора:
Name: order_number
Type: string
Description: "10-цифрен номер на поръчка от клиента"
2

Задайте правила за валидация

Добавете изисквания за формат в описанието:
"Дата във формат dd/mm/yyyy"
"Телефонен номер без интервали"
"Имейл адрес за потвърждение"

​
Разбиране на типовете параметри

String

Текстови стойности като имена, адреси или референтни номера
Type: string
Examples: "John Doe", "123 Main St"

Number

Числови стойности като суми, количества или ID-та
Type: number
Examples: 42, 99.99

true_false

Boolean стойности за да/не ситуации
Type: true_false
Examples: true, false

Помощ за форматиране

Добавете инструкции за формат в описанията
"Дата във формат dd/mm/yyyy"
"Телефон без интервали"

​
Динамични endpoints

Когато използвате променливи във вашия endpoint URL, уверете се, че ги поставяте в къдрави скоби и използвате точното име на параметъра.
Можете да направите вашите endpoints динамични, използвайки променливи: 
Основен URL:
https://api.example.com/orders/status

С променливи:
https://api.example.com/orders/{order_id}/status
AI автоматично ще замени {order_id} с действителната стойност, събрана по време на разговора.

​
Лесно тестване

Автоматично тестване

Кликнете “Test Tool”, за да стартирате тест с примерни данни:
  • String параметри: “test”
  • Number параметри: 1
  • Boolean параметри: true
Ще видите response кода и тялото, което ви помага да потвърдите, че всичко работи.

​
Функция за напреднали потребители: Интеграция с Automation Platform

Нуждаете се от по-сложна логика? Свържете вашия инструмент към automation platform за напреднали workflows.
За напреднали интеграции и сложни workflows, можете да комбинирате персонализирани инструменти с нашата Automation Platform. Ето как да създадете мощни интеграции:
  1. В automation platform:
    • Създайте нов flow
    • Добавете webhook trigger
    • Изградете вашата логика (API повиквания, трансформация на данни и др.)
    • Завършете с “Return Response”
  2. В вашия персонализиран инструмент:
    • Използвайте webhook URL като ваш endpoint
    • Добавете /sync в края
    • Пример: https://call.aiployees.com/automation/webhook/abc123/sync
Това ви позволява да:
  • Трансформирате данни преди/след API повиквания
  • Правите множество API повиквания последователно
  • Прилагате сложна бизнес логика
  • Обработвате грешки елегантно

​
Примери от реалния свят

Name: check_order
Endpoint: https://api.yourshop.com/orders/{order_number}
Parameters:
  - Name: order_number
    Type: string
    Description: "Референция на поръчка (формат: ORD-XXXXX)"
AI ще:
  1. Попита за номера на поръчката
  2. Извлече статуса
  3. Обясни датите за доставка и статуса на клиента
Name: check_slots
Endpoint: https://api.calendar.com/availability
Parameters:
  - Name: service
    Type: string
    Description: "Тип услуга (подстригване, масаж, консултация)"
  - Name: date
    Type: string
    Description: "Предпочитана дата (dd/mm/yyyy)"
AI ще:
  1. Попита за желаната услуга
  2. Получи предпочитаната дата
  3. Покаже наличните часове
Name: verify_customer
Endpoint: https://api.crm.com/verify
Parameters:
  - Name: phone
    Type: string
    Description: "10-цифрен телефонен номер"
  - Name: email
    Type: string
    Description: "Имейл адрес за верификация"
AI ще:
  1. Събере контактните данни
  2. Верифицира срещу вашата CRM
  3. Продължи на база статуса на верификацията

​
Конфигуриране на вашия AI

AI се нуждае от ясни инструкции в системния си prompt, за да използва ефективно вашите персонализирани инструменти.
Пример на секция от prompt: 
Кога да използва check_order tool:
1. Клиентът пита за статус на поръчка
2. Споменава проследяване или доставка
3. Иска да знае къде е пакетът му

Как да го използва:
1. Попитай за номер на поръчка, ако не е предоставен
2. Верифицирай формата (ORD-XXXXX)
3. Използвай инструмента за извличане на статуса
4. Обясни резултатите с прости думи
Тествайте вашите инструменти с различни разговорни потоци, за да се уверите, че AI обработва всички сценарии гладко. Започнете с прости тестови обаждания, преди да пуснете на живо.