# Craft Agent

Источник: https://docs.aicentos.com/ru/clients/craft-agent

Language: ru

> Подключение к aicentos в Craft Agent — кастомное OpenAI-совместимое соединение, общее для десктопа и craft-cli

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

## Подготовка

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

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

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

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

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

## Конфигурация для заполнения

| Поле            | Значение                                                                                        |
| --------------- | ----------------------------------------------------------------------------------------------- |
| Тип подключения | Custom (кастомный)                                                                              |
| Протокол        | `openai-completions` или `anthropic-messages`                                                   |
| Base URL        | `https://aicentos.com/v1` (OpenAI-совместимый) / `https://aicentos.com` (Anthropic-совместимый) |
| API Key         | ключ, созданный в консоли                                                                       |
| Модель          | имя модели из «витрины моделей» в консоли                                                       |

## Шаги настройки

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

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

```bash
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` напрямую:

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

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

## Проверка

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

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

## Примечания

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

## Полезные ссылки

* [Документация Craft Agents](https://thecraftagents.com/docs)
* [Репозиторий craft-agents](https://github.com/craft-ai-agents/craft-agents-oss)