ИИ Агенты

1. Перейдите в Битрикс24 Маркетплейс вашего портала Битрикс24
   
2. Найдите приложение «ИИ Агенты»
   
3. Нажмите «Установить» и подтвердите установку
   
4. После установки приложение появится в левом меню портала и профиле пользователя
   

Для работы приложения необходимо настроить интеграцию с Yandex Cloud:

1. Перейдите в консоль Yandex Cloud
   
2. Войдите в свой аккаунт или создайте новый
   
3. Выберите существующий каталог (Folder) или создайте новый:
   • Нажмите «Создать каталог»
     
   • Укажите имя (например, «ai-agents»)
     
   • Выберите облако и нажмите «Создать»
     

1. В выбранном каталоге перейдите в раздел «Сервисные аккаунты»
   
2. Нажмите «Создать сервисный аккаунт»
   
3. Укажите имя (например, ai-agents-bot)
   
4. Назначьте роли:
   • ai.assistant.user — для работы с YandexGPT
     
   • editor — для управления ресурсами
     

1. Откройте созданный сервисный аккаунт
   
2. Перейдите на вкладку «API-ключи»
   
3. Нажмите «Создать API-ключ»
   
4. Важно! Скопируйте ключ сразу — он показывается только один раз
   
5. Сохраните ключ в надёжном месте
   

1. Откройте приложение «ИИ Агенты» в Битрикс24
   
2. Перейдите на вкладку «Настройки» (доступна только администраторам)
   
3. Заполните поля:
   • YC Folder ID: вставьте скопированный Folder ID из Yandex Cloud
     
   • YC API Key: вставьте сгенерированный API-ключ
     
   • Нажмите Сохранить
     
   • Дождитесь сохранения
     

1. Перейдите на вкладку «Агенты»
   
2. Нажмите на карточку «Создать агента»
   
3. Заполните форму:
   • Название: краткое имя агента (например, «HR-консультант»)
     
   • Описание: для чего предназначен агент
     
   • Модель: выберите yandexgpt (универсальная) или yandexgpt-lite (быстрая и экономичная)
     
   • Инструкция: опишите, как агент должен отвечать (например, «Ты — HR-специалист. Отвечай на вопросы сотрудников о корпоративных правилах вежливо и по существу»)
     
   • Нажмите «Создать»
     
   • Агент будет создан и появится в списке
     

1. Нажмите на карточку созданного агента
   
2. В разделе «Файлы базы знаний» нажмите «Загрузить файл»
   
3. Выберите файл (PDF, DOCX, TXT и др.) с информацией для агента
   
4. Дождитесь завершения загрузки (появится уведомление)
   
5. После загрузки всех файлов нажмите «Обновить агента»
   
6. Дождитесь завершения индексации (может занять до нескольких минут)
   
7. Агент готов к работе с загруженными данными
   

1. Перейдите на вкладку «Мои чаты»
   
2. Нажмите «Новый чат»
   
3. Выберите агента из списка активных
   
4. Укажите название чата (опционально)
   
5. Нажмите «Создать чат»
   
6. Начните общение с агентом:
   • Введите вопрос в поле ввода
     
   • Нажмите Enter для отправки (или Shift+Enter для новой строки)
     
   • Агент ответит с учётом своей инструкции и базы знаний
     

• Редактирование: нажмите на карточку агента, измените параметры и нажмите «Сохранить»
  
• Активность: переключатель в правом верхнем углу модального окна (активные агенты доступны для создания чатов)
  
• Удаление: кнопка «Удалить» в модальном окне редактирования (удаляются все связанные чаты и файлы)
  

• Удаление чата: наведите на чат в списке и нажмите иконку корзины
  
• Информация об агенте: нажмите иконку «i» в заголовке чата
  

• На мобильных устройствах (ширина экрана < 768px) доступна только вкладка «Мои чаты»
  
• Интерфейс адаптирован для удобного общения с агентами на смартфонах
  

• Убедитесь, что вы заполнили YC Folder ID и YC API Key в настройках
  
• Проверьте корректность введённых данных (нет лишних пробелов)
  

• Проверьте, что сервисный аккаунт имеет роли ai.assistant.user и editor
  
• Убедитесь, что API-ключ действителен (не был удалён в Yandex Cloud)
  
• Проверьте лимиты вашего тарифа Yandex Cloud
  

• Уточните Инструкцию агента — опишите более детально, как он должен себя вести
  
• Проверьте, что файлы базы знаний загружены и проиндексированы (нажмите «Обновить агента» после загрузки)
  
• Попробуйте переформулировать вопрос более чётко
  

• Проверьте формат файла (поддерживаются текстовые форматы)
  
• Убедитесь, что размер файла не превышает 10 МБ
  
• Проверьте интернет-соединение
  

• Документация Yandex Cloud
  
• YandexGPT API
  
• Модели YandexGPT
  
• Создание сервисного аккаунта
  
• Управление API-ключами
  

Если у вас возникли вопросы или проблемы:

1. Откройте вкладку «О приложении»
   
2. Нажмите «Чего-то нехватает?»
   
3. Заполните форму обращения
   
4. Наша команда свяжется с вами в ближайшее время
   

Или оставьте отзыв в Битрикс24 Маркетплейс — мы постоянно улучшаем приложение на основе ваших пожеланий!