Craft Agent

Подключения LLM в Craft Agent поддерживают тип Custom; официальное описание — «любой URL, любой OpenAI-совместимый или Anthropic-совместимый эндпоинт». Если направить Base URL на aicentos, это будет работать и в десктопном приложении, и в craft-cli.

ПодготовкаКопировать ссылку на якорь

Сначала создайте в консоли отдельный ключ для Craft Agent (рекомендуемое имя craft-agent) — так проще смотреть расход по ключу.

• Консоль: https://aicentos.com
• Создание ключа: https://aicentos.com/keys
• Пополнение кошелька: https://aicentos.com/wallet

Установка десктопного приложения:

curl -fsSL https://thecraftagents.com/install-app.sh | bash

Также поддерживаются headless-сервер и использование только из командной строки.

Конфигурация для заполненияКопировать ссылку на якорь

Шаги настройкиКопировать ссылку на якорь

Десктопное приложение: откройте подключения LLM в настройках, добавьте новое, выберите тип Custom и заполните по таблице выше.

Эквивалент в командной строке:

export AICENTOS_API_KEY="sk-ваш-API-ключ"
craft-cli run --provider openai \
  --base-url https://aicentos.com/v1 \
  --api-key "$AICENTOS_API_KEY" \
  --model имя-модели \
  "Привет"

Можно также править файл конфигурации ~/.craft-agent/config.json напрямую:

{
  "llmConnections": [
    {
      "providerType": "pi_compat",
      "baseUrl": "https://aicentos.com/v1",
      "customEndpoint": { "api": "openai-completions" },
      "models": [{ "id": "имя-модели" }],
      "defaultModel": "имя-модели"
    }
  ]
}

Ключ не хранится в конфигурации в открытом виде — он лежит в credentials.enc в том же каталоге. Достаточно один раз ввести его через интерфейс; этот файл руками не правьте.

ПроверкаКопировать ссылку на якорь

craft-cli run --provider openai \
  --base-url https://aicentos.com/v1 \
  --api-key "$AICENTOS_API_KEY" \
  --model имя-модели \
  "Представься в одном предложении"

Если ответ приходит нормально, подключение работает. Затем вернитесь в консоль и проверьте расход — запросы должны учитываться на этом ключе.

ПримечанияКопировать ссылку на якорь

• providerType оставляйте pi_compat — это идентификатор кастомного эндпоинта; если заменить его именем встроенного провайдера, пойдут официальные модели.
• models нужно заполнять вручную, список моделей автоматически не подтягивается. Имена должны полностью совпадать с «витриной моделей» в консоли (см. Поддерживаемые модели).
• При работе через Anthropic-совместимый эндпоинт Base URL — https://aicentos.com, без /v1, а --provider меняется на anthropic.
• Расположение меню в десктопном приложении зависит от версии; если не находите нужный пункт, ориентируйтесь на вариант с config.json.

Полезные ссылкиКопировать ссылку на якорь

• Документация Craft Agents
• Репозиторий craft-agents