# Craft Agent

出典: https://docs.aicentos.com/ja/clients/craft-agent

Language: ja

> Craft Agent で aicentos に接続する —— カスタムの OpenAI 互換接続、デスクトップ版と craft-cli で共通

Craft Agent の LLM 接続は `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
```

ヘッドレスサーバーやコマンドラインのみの利用にも対応しています。

## 設定値

| フィールド    | 値                                                                          |
| -------- | -------------------------------------------------------------------------- |
| 接続タイプ    | Custom（カスタム）                                                               |
| プロトコル    | `openai-completions`、または `anthropic-messages`                              |
| Base URL | `https://aicentos.com/v1`（OpenAI 互換）/ `https://aicentos.com`（Anthropic 互換） |
| API Key  | コンソールで作成したキー                                                               |
| モデル      | コンソール「モデル広場」のモデル名                                                          |

## 設定手順

デスクトップ版：設定内の LLM 接続を開き、1 件追加してタイプに Custom を選び、上の表に従って入力します。

コマンドラインでの等価な書き方：

```bash
export AICENTOS_API_KEY="sk-あなたの-API-Key"
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` に保存されます。UI で一度入力すれば十分で、このファイルを手で書き換えないでください。

## テスト

```bash
craft-cli run --provider openai \
  --base-url https://aicentos.com/v1 \
  --api-key "$AICENTOS_API_KEY" \
  --model あなたのモデル名 \
  "一文で自己紹介してください"
```

正常に返れば疎通しています。コンソールに戻って使用量を確認し、リクエストがこのキーに記録されていることを確かめてください。

## 注意事項

* `providerType` は `pi_compat` のままにしてください。これがカスタムエンドポイントの識別子です。組み込み provider の名前に変えると公式モデルが使われます。
* `models` は手動で記入する必要があり、モデル一覧を自動取得しません。名前はコンソール「モデル広場」と完全に一致させる必要があります（[対応モデル](https://docs.aicentos.com/ja/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)