Конфигурация конвейера публикации нового агента

Обновлено 21 января 2026

Публикация агента на стенды GigaLab происходит с помощью конвейера GitLab CI, который запускается автоматически при создании Merge Request (MR) в репозиторий giga-agents .

В этом разделе — инструкция по добавлению конфигурации конвейера нового агента в репозиторий. В результате выполнения инструкции вы создадите MR, с помощью которого можно опубликовать агента на DEV/IFT или ПРОМ стенды.

При создании Merge Request:

можно изменять только папку вашего агента services/ваш-агент;
можно менять параметры только одного агента;
при обновлении агента в ПРОМ, обязательно увеличение версии;
нельзя самостоятельно изменять параметры ядра и выделяемых ресурсов. Для изменения этих параметров обратитесь в команду GIgaLab.

Для публикации нового агента:

Создайте новую ветку с префиксом feature/ и названием вашего агента:
```
git checkout -b feature/ваш-агент
```
В папке services создайте папку с названием вашего агента:
```
mkdir services/ваш-агент
```
Скопируйте в папку вашего агента все файлы из папки services/sample:
```
cp -R services/sample/* services/ваш-агент
```
В папке sample содержатся сертификат и шаблоны конфигурационных файлов, которые нужны для публикации агента.

После копирования структура файлов в папке вашего агента должна выглядеть так:
```
services/
└── ваш-агент/
    ├── certs/
    │   └── SberDevices_RCA.crt
    ├── values.yaml        # Общие параметры публикации
    ├── values-dev.yaml    # Параметры для среды DEV
    ├── values-ift.yaml    # Параметры для среды IFT
    ├── values-nt.yaml     # Параметры для среды NT
    ├── values-preprod.yaml# Параметры для среды PREPROD
    └── values-prod.yaml   # Параметры для среды PROD
```
Где:
- certs/ — сертификаты.
- values.yaml — общая конфигурация.
- values-<env>.yaml — параметры для окружения <env>.
Для успешного прохождения Merge Request папка агента должна содержать все файлы (сертификат и конфигурационные файлы) из папки services/sample .
В файле с общими параметрами services/ваш-агент/values.yaml укажите путь к Docker-образу агента:
```
image:
  registry: registry.sberdevices.ru
  path: public-repository/giga-labs/agents/ваш-агент
  tag: 1.0.1
```

В файлах с параметрами определенной среды services/ваш-агент/values-*.yaml, в переменных LANGCHAIN_PROJECT и PHOENIX_PROJECT_NAME замените sample на название вашего агента:

Пример заполнения параметров для DEV-среды (файл values-*.yaml):

stand: dev
agent: 
  replicaCount: 1
  env:
    LANGCHAIN_TRACING_V2: 'false' 
    PHOENIX_ENABLED: 'true'
    LANGCHAIN_PROJECT: 'ваш-агент'
    PHOENIX_PROJECT_NAME: 'ваш-агент-dev'
    
    SEARCH_PLUGIN_URL: 'https://gigachat.dev.app.sberdevices.ru/retrieval'

    #gigachat
    USE_TOKEN_PROVIDER_AGW: 'true'
    USE_GIGACHAT_ADVANCED: 'true'
    GIGACHAT_BASE_URL: 'https://gigachat.dev.sberdevices.ru/v1/'
    GIGACHAT_TIMEOUT: '120'
    GIGACHAT_SCOPE: 'GIGACHAT_API_CORP'
    GIGACHAT_VERIFY_SSL_CERTS: 'false'
    GIGACHAT_PROFANITY_CHECK: 'false'
    GIGACHAT_TOP_P: '0.1'
    GIGACHAT_MODEL: 'GigaChat-2-Max'
    DEFAULT_MODEL: 'GigaChat-2-Max'

Сохраните изменения и отправьте их в GitLab.

Если нужно создать ветку в GitLab используйте команду git push --set-upstream origin feature/ваш-агент

Ответ будет содержать ссылку для создания Merge Request:
```
remote: To create a merge request for feature/<ваш-агент>, visit:
remote:   https://git.sberdevices.ru/ihub/agents-lab/giga-agents/-/merge_requests/new?merge_request%5Bsource_branch%5D=feature%2F<ваш-агент>
```
Пройдите по ссылке и создайте Merge Request.

В заголовке и описании укажите название вашего агента.

В интерфейсе Merge Request запустится конвейер, с помощью которого можно будет опубликовать агента на среды DEV, IFT и ПРОМ.

Merge Request можно будет влить после успешной публикации агента на ПРОМ.

Инструкция по публикации агента в интерфейсе конвейера GitLab, в репозитории .

Заметили ошибку?

Выделите текст и нажмите Ctrl + Enter, чтобы сообщить нам о ней