OMI Настройка на доставчика на изкуствен интелект за агенти
OMI Агентите могат да използват външен доставчик на изкуствен интелект за езикова редакция, помощ при метаданните, изготвяне на резюмета и проверка на цитатите. Studio съхранява тайните данни за достъп на доставчика API, криптирани на сървъра на Studio API, и не връща тайната на клиента, след като тя е била запазена.
Настоящият потребителски интерфейс на Studio предлага предварителни настройки за:
- OpenAI
- Mistral AI
- Groq
- OpenRouter
- персонализирани HTTPS крайни точки, съвместими с OpenAI
OpenAI използва своя собствен формат Responses API. Останалите вградени доставчици и потребителските доставчици, съвместими с OpenAI, използват формат от типа Chat Completions API.
Настройка на OpenAI
1. Създайте ключ за OpenAI „API“
Отворете настройките на ключа „API“ в платформата OpenAI и създайте специален секретен ключ за проекта за агентите „OMI“. Препоръчва се да изберете описателно име, като например „OMI-Agent“.
Абонаментите за ChatGPT и фактурирането на OpenAI API са отделни. Самият абонамент за ChatGPT Plus не осигурява кредит за услугата „API“, поради което фактурирането на API трябва да бъде настроено отделно за акаунта или проекта в OpenAI Platform, който притежава ключа.
За специален ключ „OMI“ използвайте права от типа Ограничени, вместо да предоставяте достъп до всички функции на API.
2. Ограничете достъпа до ключа в „Responses“ API
За настоящата интеграция с OpenAI минималните изисквания към възможностите на модела са:
- Отговори (
/v1/responses) → Заявка
Следните разрешения не се изискват от агентите на „OMI“, когато е избран OpenAI, и могат да останат зададени като Няма:
- Автоматично попълване при чат
- Преобразуване на текст в реч
- В реално време
- Вграждания
- Изображения
- Модерации
- Асистенти
- Теми
- Оценки
- Фина настройка
- Файлове
- Видеоклипове
- Магазини „Vector“
- Подсказки
- Партия
- Тунели
- Набори от данни
List models също е по избор, тъй като Studio изпраща директно името на конфигурирания модел, вместо да прави запитване към каталога с модели.
След промяна на правата на ключ с ограничен достъп може да са необходими няколко минути, преди новите настройки да влязат в сила. По време на този период на прилагане Studio може временно да върне HTTP отговор 401, съдържащ:
Missing scopes: api.responses.write
Ако ключът е настроен правилно, изчакайте няколко минути и отново изпълнете теста за връзка, преди да замените ключа.
3. Настройте доставчика в Studio
В „Studio“ отворете:
Меню „Manuscript“ → „Интеграции“ → „OMI“ → „Агенти“ → „Доставчик на ИИ“
След това:
- Изберете OpenAI като доставчик.
- Studio автоматично задава крайната точка като
https://api.openai.com/v1/responses. - Въведете името на модела, който да се използва за агентите на OMI.
- Поставете ключа „API“ от OpenAI в полето „API key“.
- Изберете „Запази и тествай AI доставчика“.
Тайният ключ се изпраща към Studio API и се съхранява в криптиран вид. След като бъде запазен, потребителският интерфейс само съобщава, че такъв ключ съществува; той не извлича, нито показва съхранения ключ. Въвеждането на нов ключ е необходимо само при замяна на съществуващия тайният ключ.
4. Проверете връзката
При успешен тест в реална среда статусът на доставчика на ИИ се променя на Готов. OMI След това агентите автоматично препроверяват собствения си статус.
Ако доставчикът е конфигуриран, но не е готов, Studio показва съобщението за грешка, върнато от доставчика. Типични примери за това са недостатъчни права за достъп до ключа „API“, недостъпен модел, ограничения, свързани с фактурирането или квотите, или невалидна конфигурация на доставчика.
След като статусът на доставчика е „Готов“, запазете и тествайте самата конфигурация на агентите на „OMI“. Статусът на агентите на „OMI“ трябва да стане Готов.
Други предварителни настройки на доставчици
За Mistral AI, Groq и OpenRouter Studio автоматично попълва вградения от доставчика ендпойнт за автодопълване на чата. Обикновено потребителят трябва да въведе само името на модела и ключа „API“.
Потребителските доставчици могат да се използват, когато предоставят HTTPS крайна точка без удостоверения, съвместима със структурата на заявките и отговорите на OpenAI Chat Completions. Studio не позволява URL адреси на доставчици, съдържащи вградени удостоверения, или адреси в локални/частни мрежи за изпълнение от агенти.
Модел за сигурност
OMI Агентите са разработени на базата на принципа на минималните права и предложения, подлежащи на преглед:
- тайните данни на доставчика API се криптират в състояние на покой на сървъра на Studio API;
- тайните не се връщат на браузъра или нативния клиент след съхранението им;
- външните доставчици получават само съдържанието и обхвата, необходими за извършването на поисканата операция;
- за да може съдържанието на поверителния преглед да бъде изпратено към външна услуга, е необходимо изрично разрешение;
- директното записване на ръкописи или метаданни изисква права с повишен достъп и изрично потвърждение от страна на потребителя;
- Стандартният работен процес генерира предложение, което подлежи на преглед от страна на потребителя.
За производствени или институционални внедрявания използвайте отделни ключове на доставчика за OMI, вместо да използвате повторно ключове с общо предназначение за администриране API. Ограничете всеки ключ до най-малкия набор от възможности на доставчика, необходими за избраната интеграция.
Отстраняване на неизправности
Missing scopes: api.responses.write
Ключът на OpenAI все още няма разрешение да извиква „Responses“ API или промяната в разрешенията все още не е влязла в сила. Настройте Responses (/v1/responses) → Request, запазете разрешенията на ключа на OpenAI, изчакайте няколко минути и опитайте отново.
HTTP 401
Проверете ключа „API“, членството в проекта, ролята в организацията/проекта и обхватите на ключа с ограничен достъп. Studio включва безопасното съобщение за грешка на доставчика в резултата от теста, за да улесни диагностицирането на проблеми с разрешенията.
HTTP 400
Доставчикът прие удостовереното заявка, но отхвърли съдържанието ѝ. Проверете избрания модел и конфигурацията на доставчика. За OpenAI използвайте предварителната настройка за OpenAI, така че Studio да използва краищата на отговорите (API), а не краищата за довършване на чата (Chat Completions).
Настроен, но не е готов
Това означава, че настройките на агентите „OMI“ съществуват, но основният доставчик на изкуствен интелект не е преминал теста за връзка в реално време. Първо отстранете грешката на доставчика, след което тествайте отново агентите „OMI“.