Премини към основното съдържание
Български— Изберете език
Меню

Организации и работни пространства

Урок 2 от 14 Обновен 29 юли 2026 г. Напреднало
На тази страница
  1. Структуриране на екипа Ви в AI Studio
  2. Моделът Организация / Работно пространство
  3. Управление на роли и разрешения
  4. Най-добри практики за организацията
  5. Конкретен сценарий: настройка
  6. Ключови изводи

Структуриране на екипа Ви в AI Studio

Докато работите сами, един единствен API ключ е напълно достатъчен. Проблемите започват в момента, в който трима разработчици споделят един и същи акаунт: никой не знае кой ключ захранва кое приложение, фактурата пристига като един неразгадаем блок, а в деня, в който някой напусне екипа, се налага да анулирате всичко. AI Studio решава този проблем чрез двустепенна архитектура: Организации и Работни пространства. Разбирането на тази структура е от съществено значение за управлението на фактурирането, разрешенията и изолацията на ресурсите.

Моделът Организация / Работно пространство

Организацията стои на върха на йерархията. Тя се създава автоматично при регистрацията Ви и представлява Вашето юридическо лице – компания, екип или отдел. Тук се консолидира всичко: фактуриране, което обединява всички разходи; избор на абонаментен план (Experiment, Scale или Enterprise); лимити на използване, което означава глобални квоти за токени и заявки; и разпределение на членовете, включително покани и управление на места. Създаването на нова организация изисква само име и приемане на условията за ползване и нищо не пречи един потребител да принадлежи към няколко организации едновременно.

Работните пространства са подмножества в рамките на една Организация, проектирани да сегментират достъпа и разходите по проект, екип или среда. Всяко работно пространство изолира своите API ключове, които предоставят достъп само до собствените му ресурси, и споделя фино настроени модели и обучаващи набори от данни между своите членове. Консумацията остава проследима за всяко работно пространство поотделно, така че можете да кажете точно колко струва чатботът за поддръжка в сравнение с вътрешната търсачка.

Управление на роли и разрешения

На ниво Организация съществуват три роли с умишлено различни обхвати.

РоляФактуриранеЧленовеРаботни пространстваAPI ключове
Собственик (Owner)ДаДаДаДа
Администратор (Admin)НеДаДаДа
Член (Member)НеНеОграниченоДа

Запомнете средния ред: Администраторът управлява екипи и работни пространства, но никога не се занимава с фактуриране. Това Ви позволява да възложите техническото администриране на ръководител на машинно обучение, без да му предоставяте достъп до корпоративната кредитна карта.

Създаването на работно пространство следователно изисква права на Администратор. От страницата Admin на Вашата организация:

  1. Отидете в секцията Workspaces
  2. Кликнете върху Create Workspace
  3. Дайте му описателно име (например: production, staging, research)
  4. Конфигурирайте началните разрешения

Добавянето на сътрудник следва подобна логика:

  1. Отидете в Admin > Members
  2. Кликнете върху Invite
  3. Въведете имейл адреса на сътрудника
  4. Задайте роля (Admin, Member)
  5. Изберете работните пространства, до които ще имат достъп

Най-добри практики за организацията

Първото правило е да разделите средите. Създайте поне две работни пространства, в идеалния случай три, за да изолирате това, което се случва в разработката, от това, което засяга Вашите потребители.

Organization "MaStartup"
├── Workspace "development"    → dev API keys, reduced quotas
├── Workspace "staging"        → integration tests
└── Workspace "production"     → prod API keys, high quotas

Това разделяне предотвратява ситуация, в която безкраен цикъл, написан в петък вечер по време на разработка, да изчерпи производствените квоти, и прави проследяването на разходите по среда незабавно четимо.

Следва ротацията на ключовете. Тъй като всеки ключ е свързан с конкретно работно пространство, замяната му без прекъсване на услугата изисква специфичен ред: генерирайте новия ключ в съответното работно пространство, внедрете го във Вашето приложение, проверете дали заявките действително преминават с него и едва тогава изтрийте стария. Разменянето на последните две стъпки гарантира прекъсване на работата.

import os

# Best practice: API key via environment variable
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

Ключ, вграден директно в изходния код, винаги ще попадне в Git хранилище, след това в историята на това хранилище, където ще оцелее въпреки всички Ваши опити за почистване. Използвайте променлива на средата още от първия ред.

В големите организации управлението също печели от наличието на едно работно пространство за всеки функционален екип – наука за данни, бекенд, продукт – плюс специализирано работно пространство за фино настройване, което централизира наборите от данни, вместо да позволява тяхното дублиране. Изричните имена на работните пространства правят месечното отчитане много по-лесно.

Конкретен сценарий: настройка

Нека разгледаме компания от петнадесет души, която внедрява Mistral. Техническият директор (CTO) създава Организацията и се абонира за плана Scale, след което отваря три работни пространства: dev, staging и prod. Разработчиците получават достъп като Членове, ограничен до работното пространство dev, докато ръководителят на машинното обучение получава достъп като Администратор до и трите. Всяко работно пространство има свои собствени API ключове, изолирани едно от друго, така че изтичането на ключ за разработка не компрометира нищо в производствената среда.

Таблото за управление на администратора, достъпно на admin.mistral.ai, след това показва консумацията по работни пространства. Това е таблицата, която техническият директор ще отвори в края на месеца, за да разпредели разходите по проекти, без да се налага да внедрява каквито и да е инструменти в кода.

Ключови изводи

  • Организацията е нивото за фактуриране и глобално управление
  • Работните пространства изолират API ключовете, фино настроените модели и разходите
  • Винаги разделяйте разработката, тестването (staging) и производството в отделни работни пространства
  • Съхранявайте API ключовете в променливи на средата, никога в кода
  • Таблото за управление на администратора Ви позволява да проследявате консумацията по работни пространства в реално време