# Действие YCLIENTS: Получить информацию о специалисте

## Назначение

Получение подробной информации о специалисте:

* специализация;
* описание из раздела **«Страница мастера»** в **YCLIENTS;**
* услуги, которые оказывает специалист.

Получение информации о специалистах особенно полезно, если у вас их много и у каждого заполнено подробное описание в **YCLIENTS**.

{% hint style="info" %}
Если указаны **только имя, фамилия и специализация**, достаточно использования функций чтения расписания и записи — в этом случае специалисты будут передаваться в параметрах соответствующих функций.\
\
Используйте данную функцию **ТОЛЬКО** в том случае, если у специалистов заполнено описание.
{% endhint %}

## Когда используется

Функция вызывается, если пользователь спрашивает, например:

* "Кто такая Анна?"
* "Расскажите о мастере Ольга"
* "Какой опыт у Ивана?"

## Шаг 1. Имя и описание функции

**Рекомендуемое имя функции:** <kbd>get\_specialist\_info</kbd>

Использование данного имени рекомендуется, так как с ним протестирована корректная работа ИИ-агента.

**Рекомендуемое описание функции:**\ <kbd>Получить информацию о специалисте по его имени.</kbd>

## Шаг 2. Добавление параметра функции

Для настройки необходимо добавить 1 параметр.

| Параметр         | Тип       | Рекомендуемая инструкция для параметра | Обязательный |
| ---------------- | --------- | -------------------------------------- | ------------ |
| specialist\_name | Текстовый | Имя специалиста (поля: фамилия, имя)   | Да           |

Настройка параметра `specialist_name` зависит от того, включена ли **автоматическая загрузка специалистов** на странице интеграции — подробную информацию вы можете прочитать в [статье](/functional/functions/sending-result/yclients/nastroika-parametrov-specialist_name-i-service_name.md).

## Шаг 3. Выбор действия

В блоке **«Выбор действия»** в выпадающем списке выберите:

Получить информацию о специалисте

## Шаг 4. Настройка основных параметров

В настройках действия сопоставьте поля:

В поле **«Имя специалиста»** → выберите параметр `specialist_name`

***

## Результат функции

Функция возвращает:

* Имя из главной карточки;
* Полное имя;
* Специализацию;
* Описание (из раздела **«Страница мастера»** во вкладке **«Онлайн-запись»** в настройках сотрудника в **YCLIENTS**);
* Услуги, которые оказывает специалист.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.nextbot.ru/functional/functions/sending-result/yclients/deistvie-yclients-poluchit-informaciyu-o-specialiste.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.