doctor-booking-v4 v2.2.1A

Immutable. This exact content never changes and is served at /api/v1/blob/92b9acf032ef83dd.

---
name: doctor-booking-v4
description: "Помогает выбрать клинику и врача, посмотреть свободные слоты и оформить очную запись через DocDoc API 1.0.13."
version: 2.2.1
type: extension
plugin_api: "2.0"
runtime: python3
entry: plugin.py
permissions: [net, read_settings, tool]
env_from_settings: [DOCDOC_PID]
requested_keys:
  - key: DOCDOC_PID
    description: "Партнёрский PID DocDoc для запросов к API записи."
when_to_use: "Пользователь хочет записаться на очную консультацию к врачу или выбрать специальность для последующей записи. Не для медицинской консультации, диагностики или экстренной помощи."
timeout_sec: 60
---

# Doctor booking (DocDoc API 1.0.13)

Расширение помогает найти доступную клинику и врача, показать актуальные
слоты, оформить и отменить запись на очную консультацию. Для работы владелец
добавляет `DOCDOC_PID` в Settings → Secrets и выдаёт навыку доступ через
Skills → Grant access. Никогда не запрашивайте и не показывайте этот ключ в
чате.

## Границы и безопасность

Это навигатор к врачу, а не медицинский консультант: не ставьте диагнозы и не
назначайте лечение. При выраженной одышке, потере сознания, судорогах, сильной
боли в груди, признаках инсульта, неконтролируемом кровотечении, тяжёлой
аллергии, угрозе себе или другим — не вызывайте инструменты записи; предложите
немедленно обратиться по номеру 112/103.

Не используйте навык для записи животных, салонных/wellness/фитнес-услуг,
анализов, МРТ/КТ/УЗИ или отдельных процедур. Не передавайте симптомы, возраст,
пол и иной медицинский контекст в `docdoc_*` инструменты.

## Сценарий

1. Если город неизвестен, получите его идентификатор через `docdoc_get_cities`.
2. Если нужна помощь с выбором специальности, задайте не более трёх коротких
   вопросов и предложите одну-две специальности; дождитесь согласия.
3. Получите клиники, затем врачей выбранной клиники или специальности, затем
   слоты. Показывайте 3–5 вариантов и ждите явного выбора на каждом шаге.
4. Перед `docdoc_create_request` покажите сводку выбранных клиники, врача,
   адреса и времени; получите отдельное подтверждение, имя и телефон. Берите
   все идентификаторы только из ответов инструментов.
5. При `validate` запросите код SMS и повторите создание только с `requestId`.
   При таймауте или `status_unknown` не повторяйте запрос автоматически.
6. Отменяйте только запись, созданную в текущем диалоге: покажите её сводку и
   получите отдельное подтверждение перед `docdoc_cancel_request`.

API: `https://api.docdoc.ru/public/rest/1.0.13`; PID передаётся только как
авторизационный query-параметр.