Примеры API
Как cookbook у Mistral: сначала таблица, потом у каждого навыка — что делает, как дернуть, живой JSON и на что смотреть. Не лендинг. Карточки только с продовых ответов.
Протокол Яндекс.Диалогов. POST с телом сессии. Пустой GET даёт заминку — это тоже живой ответ, не пример диалога.
Доступные эндпоинты
| Навык | Что это | Путь | Статус |
|---|---|---|---|
| Умник | Голосовой помощник: факты, время, новости, меню | /alice/ |
НА ПРОДЕ |
| Подружка | Разговорный навык, tts с загрузкой голоса | /alice-podruzhka/ |
НА ПРОДЕ |
| Коуч | Бизнес-коуч: вопросы, не советы | /coach/ |
НА ПРОДЕ |
| Игры | Игровые сессии + события аналитики | /game/ |
НА ПРОДЕ |
| Лев | Вечерний собеседник. Каталог живой, после ремонта не катили | /alice-lev-54a5ac80/ |
КАТАЛОГ ≠ НОВЫЙ ПРОД |
Умник
Что делает
Большой Умник на alice-bridge. Приветствие сразу отдаёт меню: факт, время, новости. Лимита на день в тексте нет.
Как дернуть
curl -s https://big-mind.ru/alice/ \
-H 'Content-Type: application/json' \
-d '{"version":"1.0","session":{"message_id":0,"session_id":"demo","new":true,"user":{"user_id":"demo"},"application":{"application_id":"demo"}},"request":{"command":"привет","original_utterance":"привет","type":"SimpleUtterance"}}'
JSON
{
"version": "1.0",
"response": {
"end_session": false,
"text": "Привет! Я Большой Умник — твой голосовой помощник с интеллектом.\\n\\n• расскажи о себе\\n• задай любой вопрос\\n• попроси интересный факт\\n• «который час» — скажу время\\n• «новости» — свежие новости\\n\\nСкажи «меню» — покажу всё, что умею.\\nСпрашивай сколько нужно — лимита на день нет.",
"tts": "Привет! Я Большой Умник. Задай любой вопрос или попроси факт — а если не знаешь, с чего начать, скажи «меню».",
"buttons": [
{"title": "Расскажи факт", "hide": true},
{"title": "Который час", "hide": true},
{"title": "Новости", "hide": true},
{"title": "Меню", "hide": true}
]
}
}
На что смотреть
response.text— меню сразу, без лимита на день.- Кнопки: факт / час / новости / меню.
- Пустой GET:
{"text":"Извини, у меня заминка. Повтори, пожалуйста."}— не диалог.
Подружка
Что делает
Разговорный навык на :9106. Голос в tts через speaker audio=dialogs-upload/…opus.
Как дернуть
curl -s https://big-mind.ru/alice-podruzhka/ \
-H 'Content-Type: application/json' \
-d '{"version":"1.0","session":{"message_id":0,"session_id":"demo","new":true,"user":{"user_id":"demo"},"application":{"application_id":"demo"}},"request":{"command":"привет","original_utterance":"привет","type":"SimpleUtterance"}}'
JSON
{
"version": "1.0",
"response": {
"end_session": false,
"text": "О, приветик! Ну наконец-то! Это я — твоя подружка, весёлая и на позитиве. Могу поговорить, поддержать или рассказать что-нибудь интересное. А чтобы нам было интереснее общаться — расскажи немного о себе. Как тебя зовут? Чем увлекаешься? Что было сегодня?",
"tts": "<speaker audio=\"dialogs-upload/…opus\"> О, приветик! …",
"buttons": [{"title": "Рассказать о себе", "hide": true}]
}
}
На что смотреть
- Живой opus в
tts, не только текст. - Одна кнопка «Рассказать о себе».
Коуч
Что делает
Личный бизнес-коуч. Вопросы, не готовые советы.
Как дернуть
curl -s https://big-mind.ru/coach/ \
-H 'Content-Type: application/json' \
-d '{"version":"1.0","session":{"message_id":0,"session_id":"demo","new":true,"user":{"user_id":"demo"},"application":{"application_id":"demo"}},"request":{"command":"привет","original_utterance":"привет","type":"SimpleUtterance"}}'
JSON
{
"version": "1.0",
"response": {
"end_session": false,
"text": "Здравствуй. Я «Личный бизнес-коуч», твой бизнес-коуч. Я не даю готовых советов — я задаю вопросы, которые помогают тебе самому найти решение. Над чем хочешь поработать сегодня?",
"buttons": [
{"title": "Поставить цель", "hide": true},
{"title": "Разобрать проблему", "hide": true},
{"title": "Привяжи телеграм", "hide": true}
]
}
}
На что смотреть
- В тексте прямо: не советы, а вопросы.
- Кнопка «Привяжи телеграм» — отдельный контур, не ответ коуча.
Игры
Что делает
Игровые сессии на /game/. «привет» игрой не является — это живой отказ, не выдуманный пример.
Как дернуть
curl -s https://big-mind.ru/game/ \
-H 'Content-Type: application/json' \
-d '{"version":"1.0","session":{"message_id":0,"session_id":"demo","new":true,"user":{"user_id":"demo"},"application":{"application_id":"demo"}},"request":{"command":"привет","original_utterance":"привет","type":"SimpleUtterance"}}'
JSON
{
"version": "1.0",
"response": {
"end_session": false,
"text": "Такой игры пока нет. Хочешь попробовать демо-игру?",
"tts": "Такой игры пока нет. Хочешь попробовать демо-игру?"
}
}
На что смотреть
- Кнопок нет. Стартовать игру отдельной командой, не «привет».
- Демо:
https://big-mind.ru/game/persuadeна витрине, это не этот webhook.
Лев
Что делает
Вечерний собеседник. Карточка в каталоге живая. После локального ремонта на этот путь не катили. Ответ ниже — старый прод, не новый код.
Как дернуть
curl -s https://big-mind.ru/alice-lev-54a5ac80/ \
-H 'Content-Type: application/json' \
-d '{"version":"1.0","session":{"message_id":0,"session_id":"demo","new":true,"user":{"user_id":"demo"},"application":{"application_id":"demo"}},"request":{"command":"привет","original_utterance":"привет","type":"SimpleUtterance"}}'
JSON
{
"version": "1.0",
"response": {
"end_session": false,
"text": "Привет. Я Лев, твой вечерний собеседник. … Сохранить это между нами?",
"buttons": [
{"title": "Про мой день", "hide": true},
{"title": "Подышим вместе", "hide": true},
{"title": "Вспомнить хорошее", "hide": true}
]
}
}
На что смотреть
- Путь живой, код на Маке новее.
- Не считать этот JSON проверкой свежего деплоя.
/monitor
Сюда не входит. Лента флота и ops — другой контур. Старый Scalar со спекой лежит в scalar.html.