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. Если нужна помощь с выбором специальности, задайте не более трёх коротких

вопросов и предложите одну-две специальности; дождитесь согласия.

1. Получите клиники, затем врачей выбранной клиники или специальности, затем

слоты. Показывайте 3–5 вариантов и ждите явного выбора на каждом шаге.

1. Перед docdoc_create_request покажите сводку выбранных клиники, врача,

адреса и времени; получите отдельное подтверждение, имя и телефон. Берите все идентификаторы только из ответов инструментов.

1. При validate запросите код SMS и повторите создание только с requestId.

При таймауте или status_unknown не повторяйте запрос автоматически.

1. Отменяйте только запись, созданную в текущем диалоге: покажите её сводку и

получите отдельное подтверждение перед docdoc_cancel_request.

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