aicentosFx
Использование aicentos в Fx — добавление кастомного подключения модели через пользовательский settings.json
Обновлено:
Fx — кодинг-агент от Vercel Labs: единый нативный бинарник, написанный на Zig, без привязки к модели. Кастомные подключения моделей задаются в пользовательском ~/.fx/settings.json — направьте base URL на aicentos.
Сразу отметим частую ловушку: .fx.json в корне проекта — это другое: он намеренно не допускает большинство полей (включая модель), чтобы склонированный репозиторий не мог подменить вашу модель или эндпоинт. Кастомный эндпоинт обязательно пишите в ~/.fx/settings.json — в .fx.json он не сработает.
Подготовка
Сначала создайте на странице «API Key» в консоли отдельный ключ для Fx (рекомендуемое имя fx — так проще отслеживать расход):
- Консоль: https://aicentos.com
- Создание ключа: https://aicentos.com/keys
- Пополнение при нехватке баланса: https://aicentos.com/wallet
Убедитесь, что Fx установлен:
curl -fsSL https://fx.sh/setup.sh | bash
fx --versionКонфигурация для заполнения
| Поле | Значение |
|---|---|
| Файл конфигурации | ~/.fx/settings.json |
| Base URL | https://aicentos.com/v1 |
| API Key | ключ, созданный в консоли |
| Модель | имя модели из «витрины моделей» в консоли |
Шаги настройки
1. Отредактируйте пользовательские настройки
В ~/.fx/settings.json зарегистрируйте подключение в формате «кастомного подключения модели». Структуру полей объекта подключения сверяйте с официальной документацией:
- Вход в документацию: https://fx.sh/docs
- README: https://github.com/vercel-labs/fx
Адрес API в подключении укажите:
https://aicentos.com/v1API Key — тот, что создан в консоли; имена моделей — по «витрине моделей» в консоли.
2. Укажите использование этого подключения
Fx позволяет задать провайдера и модель при запуске:
fx provider local FX_MODEL=gpt-4o fx ask "Ответь одним предложением: сколько будет 1+1"Можно и через переменную окружения:
export FX_MODEL="gpt-4o"3. Подтвердите текущего провайдера
Fx запоминает выбор по провайдеру: при следующем запуске продолжит использоваться провайдер, выбранный в прошлый раз.
Проверка
Сначала проверьте связность нейтральным промптом без побочных эффектов:
fx ask "Ответь одним предложением: сколько будет 1+1"Если ответ возвращается нормально, подключение выполнено. При ошибке аутентификации в первую очередь проверьте, есть ли /v1 в base URL и нет ли лишних пробелов в API Key.
Примечания
- Не трогайте
.fx.json. В файле уровня проекта разрешены только отдельные поля вродеprovider_orderиprovider_strict; поляmodelтам нет, и для настройки кастомного эндпоинта он не предназначен. provider_order/provider_strict— параметры маршрутизации Vercel AI Gateway, действуют только на запросы к Gateway; кастомные подключения моделей их игнорируют, так что переключить апстрим с их помощью не выйдет.- Официальная поддержка кастомных подключений моделей в Fx ещё развивается; в ранних версиях может понадобиться свежая сборка, чтобы распознать настройки. После обновления сначала выполните тестовую команду выше и только потом переходите к реальной работе.
- Скрипт бинарной установки тянет файлы из сети — перед выполнением самостоятельно убедитесь в доверии к источнику.
Полезные ссылки
- Страница проекта: https://github.com/vercel-labs/fx