Skip to content

Yandex Cloud Connector

Jump to bottom
Yoshkar-Ola Administration edited this page Jun 3, 2026 · 7 revisions

Yandex Cloud Connector

Yandex Cloud Connector подключает к iola-cli сервисы Yandex Cloud, которые нужны жителю:

  • Яндекс Геокодер - адреса, координаты, расстояния, ссылки на карту и deeplink Яндекс Go;
  • YandexGPT - российская AI-модель в меню /model.

Это отдельный коннектор. Он не заменяет обычный Yandex Connector для Диска, Почты, Календаря и Контактов.

Как подключить

Самый простой путь:

iola master

В мастере выберите:

15. Yandex Cloud Connector - геокодинг и YandexGPT

CLI не просто открывает консоль. Он печатает короткую инструкцию, что делать дальше, и только потом просит вставить ключи.

Что делает пользователь:

  1. Входит в свой Яндекс-аккаунт.
  2. Если Яндекс просит создать облако или каталог, создает их. Названия можно оставить простыми: iola-cli и default.
  3. Для геокодера открывает Кабинет разработчика: https://developer.tech.yandex.ru/services/2.
  4. Выбирает API Геокодера, создает API key и копирует значение ключа.
  5. Возвращается в окно CLI и вставляет ключ в поле YANDEX_GEOCODER_API_KEY.
  6. Если нужен YandexGPT, в Yandex Cloud копирует ID каталога, создает сервисный аккаунт и API-ключ с правом yc.ai.foundationModels.execute.
  7. Если YandexGPT пока не нужен, на вопрос CLI можно ответить n и подключить модель позже через /model.

CLI попросит сохранить:

  • ключ YANDEX_GEOCODER_API_KEY;
  • при необходимости YandexGPT API key;
  • при необходимости YANDEXGPT_FOLDER_ID.

Геокодер включается по умолчанию. YandexGPT можно включить сразу или позже через /model.

Прямые команды:

iola yandex cloud setup
iola yandex cloud status
iola yandex cloud doctor
iola yandex cloud enable geocoder yandexgpt
iola yandex cloud disable yandexgpt
iola yandex cloud delete

Ключи сохраняются только локально в:

~/.iola/secrets.json

YandexGPT в /model

Откройте меню моделей:

/model

Выберите:

2. Российские AI (YandexGPT/GigaChat)

Если Yandex Cloud Connector еще не подключен, CLI объяснит, что нужен коннектор, и предложит включить его. Если отказаться, CLI вернется в меню выбора моделей.

Геокодер

После подключения доступны geo-команды:

iola geo key doctor
iola geo geocode "Йошкар-Ола, улица Петрова, 15"
iola geo nearby "Йошкар-Ола, улица Петрова, 15" --dataset all --limit 5
iola geo distance --from "Петрова 15" --to "школа 7"
iola geo map-link "школа 7"
iola geo route-context "школа 7"

Геокодер также нужен для Яндекс Go deeplink:

iola yandex go link --from "Йошкар-Ола, Красноармейская 43" --to "Йошкар-Ола, Гагарина 8"
iola yandex go open --from "Йошкар-Ола, Красноармейская 43" --to "Йошкар-Ола, Гагарина 8" --tariff econom

Если ключ геокодера не найден, CLI пишет понятную ошибку и предлагает:

iola master

или:

iola yandex cloud setup

Яндекс Go

Сейчас iola-cli поддерживает только безопасный сценарий:

  • уточнить адрес отправления и назначения;
  • получить координаты через геокодер;
  • сформировать deeplink маршрута Яндекс Go;
  • при команде open открыть ссылку в браузере или приложении.

CLI не нажимает кнопку заказа, не подтверждает поездку, не списывает деньги и не обещает цену. Цена, повышенный спрос, детское кресло, назначение машины и отмена поездки требуют партнерского clid/apikey от Яндекса.

Примеры:

iola yandex go link --from "Йошкар-Ола, Ленинский 24" --to "Йошкар-Ола, Кремлевская 26"
iola ask "сделай ссылку Яндекс Go от Йошкар-Ола, Красноармейская 43 до Йошкар-Ола, Гагарина 8"

Ручная инструкция по ключу геокодера

Если нужен только геокодер без YandexGPT, можно использовать отдельную инструкцию:

Yandex Geocoder API key

Бесплатный лимит API Геокодера для обычного ключа у Яндекса указан как до 1000 запросов в сутки. Новый ключ может активироваться с задержкой 15-30 минут.

Важно

Yandex Cloud тарифицирует YandexGPT по правилам Yandex Cloud. Перед активным использованием модели проверьте лимиты и оплату в консоли.

Не публикуйте API-ключи и folder ID в GitHub, README, issue, wiki или чатах поддержки.

Clone this wiki locally