github-ops
36 lines
2.7 KiB
Markdown
36 lines
2.7 KiB
Markdown
# Примеры Dadata
|
|
|
|
В этой папке лежат примеры операций Crank для Dadata. Их можно импортировать в интерфейсе Crank и использовать как основу для MCP-инструментов.
|
|
|
|
Dadata не предоставляет эти методы полностью без ключей. Для работы нужны ключи из личного кабинета Dadata:
|
|
|
|
- `Authorization: Token <API_KEY>` нужен для всех примеров.
|
|
- `X-Secret: <SECRET_KEY>` дополнительно нужен для методов стандартизации.
|
|
|
|
В YAML-файлах стоят заглушки `Token CHANGE_ME_DADATA_API_KEY` и `CHANGE_ME_DADATA_SECRET_KEY`. Перед использованием замените их в настройках операции на реальные значения. Не добавляйте ключи во входные параметры инструмента: тогда MCP-клиент и агент смогут их увидеть.
|
|
|
|
## Группа “Паспорта”
|
|
|
|
- `passports/dadata_clean_passport.operation.yaml` проверяет и разбирает номер паспорта через метод стандартизации.
|
|
- `passports/dadata_suggest_fms_unit.operation.yaml` ищет подразделение ФМС/МВД по коду или названию.
|
|
|
|
## Группа “Автомобили”
|
|
|
|
- `cars/dadata_clean_vehicle.operation.yaml` распознает марку и модель автомобиля из свободного текста.
|
|
- `cars/dadata_suggest_car_brand.operation.yaml` ищет марку автомобиля по русскому или английскому названию.
|
|
|
|
## Как проверить
|
|
|
|
1. Импортируйте нужный YAML-файл в Crank.
|
|
2. Замените заголовки-заглушки на реальные ключи Dadata.
|
|
3. Запустите тест операции в интерфейсе Crank.
|
|
4. Создайте агента, привяжите к нему операции одной группы и опубликуйте агента.
|
|
5. Подключите MCP-клиент к опубликованному агенту и вызовите нужный инструмент.
|
|
|
|
Документация Dadata:
|
|
|
|
- Проверка паспорта: https://dadata.ru/api/clean/passport/
|
|
- Подразделения ФМС/МВД: https://dadata.ru/api/suggest/fms_unit/
|
|
- Стандартизация автомобилей: https://dadata.ru/api/clean/vehicle/
|
|
- Марки автомобилей: https://dadata.ru/api/suggest/car_brand/
|