AI модели и собствен ключ

AI в панела работи на много места: описания на стоки и ястия, отговори на гост, анализ на обаждания, сглобяване на учебни материали, помощник по раздели. По подразбиране модела за всяка задача избираме ние — и за повечето това е достатъчно.

Разделът „AI модели (LLM)“ е нужен на тези, за които е важно сами да решават: кой сервиз отговаря за асистентските функции на акаунта и на кой модел работи. А ако вече имате свой договор с доставчик — можете да подключите собствен ключ, и извикванията ще минават през него.

Отваряне: картата „AI модели (LLM)“ в магазина за разширения (категория „Акаунт“) → admin.cenaly.com/ai-models. Разделът няма собствен пункт в менюто — това не е грешка, вратата е една, от магазина. Разделът е достъпен само за собственика на акаунта.

Защо е нужен този раздел#

Какво е нужно за стартиране#

Стъпка 1. Подключване на готов AI сервиз#

Първият блок на страницата е „AI сервизи Cenaly“: ChatGPT (OpenAI), Gemini (Google), Grok (xAI) и DeepSeek. Подключването става с едно кликване:

1. Натиснете „Подключи“ до желания сервиз — не са нужни API ключове, заявката минава през нашата инфраструктура.
2. При подключения сервиз ще се появи ред „Модел“ — изберете конкретен модел от списъка на сервиза (списъкът е различен за всеки и се обновява от време на време).
3. Ненужният сервиз се изключва с бутона „Изключи“.

Плащането е с AI кредити на акаунта, както при всички други AI функции: не се появява отделна фактура за „подключване на ChatGPT“, плащате за фактическите извиквания.

Стъпка 2. Подключване на собствен ключ#

Вторият блок е „Персонализирани LLM“. Той е за тези, които имат собствен достъп до модел: собствен договор с доставчик, корпоративен шлюз или собствено разгърнат модел с OpenAI-съвместим API.

1. „Добави персонализиран LLM“ и попълнете: Име (как ще го разпознавате), Base URL API — адресът заедно с версията, например https://api.example.com/v1 (само https), API ключ, Модел — id на модела при този доставчик.
2. Натиснете „Провери връзката“ — ще бъде изпратена тестова заявка и ще видите „Има връзка“ със замерване на закъснението или причината за отказа. Проверката работи и преди запазване, и след това върху вече запазен запис.
3. „Добави“ — подключването ще се появи в списъка. То може временно да бъде изключено с превключвател или изтрито (с потвърждение: заедно със записа се изтрива и запазеният ключ).

Как се съхранява ключът: той се намира на сървъра и не се връща обратно в браузъра — в интерфейса се вижда само бележката „API ключът е запазен“ и маска. Ключът може да бъде подменен, но не може да бъде прочетен от панела.

Какво става с парите: за извиквания по вашия ключ AI кредити не се удържат — плащате директно на своя доставчик. Но ако вашият ендпойнт не отговори, извикването не се проваля: то минава през обичайната платформена опашка — и точно това извикване вече се отчита по кредити. Проверявайте достъпността на своя ендпойнт, ако видите разход там, където не сте го очаквали.

Подключванията могат да бъдат няколко (до десет) — например различни модели за различни експерименти; работят тези, при които превключвателят е включен.

Стъпка 3. Избор на предпочитан модел#

Третият блок е „Предпочитан модел“, превключвател за целия акаунт:

• „По подразбиране (препоръчва се според задачата)“ — платформата избира модела сама, отделно за всяка функция. Това е първоначалното състояние;
• конкретен сервиз или персонализирано подключване — тях асистентските функции ще използват на първо място.

Ред на опитите при избран предпочитан модел: първо вашият персонализиран ендпойнт (ако той е предпочетен), след това платформеното извикване на избрания модел, след това обичайният резервен път — за да не „умира“ функцията заради един недостъпен доставчик.

⚠️ Изборът действа не във всички AI функции — подробности в „Ограничения“.

Къде се вижда разходът#

Разходът за AI се намира на страницата абонамент, в две карти: „LLM кредити“ — остатъкът по баланса за AI задачи, и „AI разходи“ — месечен разход по функции, прогноза на фактурата до края на месеца и месечен таван. По редовете се вижда коя точно функция харчи: описания, обаждания, преводач, обучение.

Редове за извиквания по вашия собствен ключ там няма да има — такива извиквания не изразходват нашия баланс.

Ограничения#

• Изборът не действа на cenaly.ru. В руския контур ИИ функциите работят на YandexGPT и настройките на този раздел не се питат там: страницата ще се отвори и ще се запази, но няма кой да я приложи. Това е следствие от изискванията за обработка на данни, а не забравена настройка.
• Изборът не действа при извиквания с инструменти. Част от функциите са устроени като „модел + инструменти“ — ИИ ботът на гостуващия чат, копилотът на панела, подсказвачът на писма в пощата. Те работят на свой модел независимо от това, което е избрано тук.
• Разделът е само за собственика. Служителят няма да го види в менюто, а по пряка връзка ще получи екран за грешка при зареждане с бутон „Повтори“, а не учтиво „няма достъп“ — знаем, поправяме го.
• Персоналният ключ няма нито срок, нито автоматична ротация. Сменяте ключа при доставчика — сменете го и тук, иначе извикванията ще започнат да минават по резервен път (и срещу кредити).
• Само OpenAI-съвместим API и само https. Крайната точка се указва заедно с версията на пътя; произволни протоколи и собствени формати на отговор не се поддържат.
• Списъка с модели на вашия доставчик не го знаем — id на модела въвеждате ръчно, от документацията на доставчика.
• Готовите услуги са четири. ChatGPT, Gemini, Grok, DeepSeek; останалото — чрез персонално свързване.

Отстраняване на неизправности#

Общ преглед по симптоми — отстраняване на неизправности; ако нищо не помогна, пишете ни — как да получите помощ.

Често задавани въпроси#

Нужно ли е изобщо да влизам в този раздел?#

Не. Без него всичко работи: платформата сама подбира модел за всяка задача. Разделът е нужен, ако искате сами да изберете модел или да свържете собствен ключ.

Нужен ли е собствен ключ OpenAI, за да използвам ИИ?#

Не. Готовите услуги се свързват с едно кликване и работят през нашата инфраструктура, плащането е с ИИ кредити на акаунта. Собственият ключ е алтернатива, а не изискване.

Собственият ключ е по-евтин?#

Зависи от договора ви с доставчика. Технически това е „покрай нашата сметка“: за такива извиквания ИИ кредити не се удържат, а плащате вие директно на доставчика.

Кой вижда моя API ключ?#

Никой от интерфейса: ключът се записва на сървъра и не се връща обратно в браузъра — ще видите само отметка, че е запазен. Разделът е достъпен единствено за собственика на акаунта.

Мога ли да избера различни модели за различни функции?#

Не, предпочитанието е едно за акаунта. Различни модели за различни задачи — това е именно режимът „по подразбиране“, в който избира платформата.

Защо на cenaly.ru изборът не работи?#

Руският контур работи на YandexGPT: данните не напускат контура, затова външни доставчици и собствена крайна точка не се свързват там.

Какво ще стане, ако моята крайна точка временно е недостъпна?#

Функцията няма да се счупи: извикването ще мине по обичайната платформена опашка — и ще бъде отчетено с ИИ кредити. Мълчалива загуба на заявката няма да има.

Колко струва самата карта „ИИ-модели“?#

Няма отделно плащане за свързване на картата — плащате само за фактическото използване на моделите през нашата инфраструктура.

Свързани раздели#

• Абонамент — картите „LLM кредити“ и „Разходи за ИИ“: остатък, разход по функции и месечен таван
• Магазин за приложения — единствената врата към раздела „ИИ-модели“
• База от знания — избор на ИИ доставчик за изграждане на базата и съгласие за обработка
• Обучение на служители — кой модел събира учебните материали и задачи
• ИИ преводач за госта — една от функциите, които харчат ИИ баланса
• Чат с гости — ИИ ботът, който работи на свой модел независимо от този избор
• Поща и ИИ автоотговорник — още една функция „модел плюс инструменти“, минаваща покрай този избор
• Как да получите помощ — ако свързването не минава проверката