Примеры 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.