Craft Agent

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

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

設定値アンカーリンクをコピー

設定手順アンカーリンクをコピー

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

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

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 を直接編集してもかまいません：

{
  "llmConnections": [
    {
      "providerType": "pi_compat",
      "baseUrl": "https://aicentos.com/v1",
      "customEndpoint": { "api": "openai-completions" },
      "models": [{ "id": "あなたのモデル名" }],
      "defaultModel": "あなたのモデル名"
    }
  ]
}

キーは平文の設定には書かれず、同じディレクトリの credentials.enc に保存されます。UI で一度入力すれば十分で、このファイルを手で書き換えないでください。

テストアンカーリンクをコピー

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

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

注意事項アンカーリンクをコピー

• providerType は pi_compat のままにしてください。これがカスタムエンドポイントの識別子です。組み込み provider の名前に変えると公式モデルが使われます。
• models は手動で記入する必要があり、モデル一覧を自動取得しません。名前はコンソール「モデル広場」と完全に一致させる必要があります（対応モデル を参照）。
• Anthropic 互換エンドポイントを使う場合、Base URL は https://aicentos.com で /v1 は付けず、--provider は anthropic に変更します。
• デスクトップ版のメニュー位置はバージョンによって変わるため、見つからない場合は config.json の書き方を基準にしてください。

関連リンクアンカーリンクをコピー

• Craft Agents ドキュメント
• craft-agents リポジトリ