omp カスタムプロバイダーのセットアップ

omp は、バンドルされたカタログ ~/.omp/agent/models.yml、ランタイム検出、および拡張機能に登録されたモデルを 1 つのレジストリに結合します。 TokenHub はカスタム models.yml プロバイダーであり、tokenhub/<model-id> として選択されます。

ステップ 1: omp が解決できる資格情報を設定する

export TOKENHUB_API_KEY="sk-..."

apiKey は、環境変数名またはリテラル値として解決されます。 TOKENHUB_API_KEY が存在する場合、omp はその値を使用します。それ以外の場合は、そのテキストをキーとして送信します。変数を設定した後、変数が存在することを確認します。

ステップ 2: ~/.omp/agent/models.yml を編集する

providers:
  tokenhub:
    baseUrl: __API_BASE_URL__/v1
    api: openai-completions
    apiKey: TOKENHUB_API_KEY
    authHeader: true
    models:
      - id: YOUR_TOKENHUB_MODEL_ID
        name: TokenHub / YOUR_TOKENHUB_MODEL_ID
        contextWindow: 128000
        maxTokens: 8192

authHeader: true は、リクエストごとに Authorization: Bearer <key> を挿入します。 contextWindow と maxTokens を、正確な TokenHub モデルの値に置き換えます。

ステップ 3: プロバイダーがロードされ、使用可能であることを確認する

omp models
omp models find YOUR_TOKENHUB_MODEL_ID

モデルは選択可能にならずに omp のレジストリに入ることがあります。公式の可用性ルールは、プロバイダーが有効な disabledProviders リストに含まれておらず、キーがないか、解決可能な資格情報を持っていることです。 tokenhub が無効になっている間は、有効なキーでプロバイダーを復元できません。

omp の優先順位で資格情報の競合を解決する

1 つのプロバイダー上の複数の資格情報の場合、omp はランタイム --api-key、models.yml apiKey、ローカル認証ストア API キー、OAuth、プロバイダー環境変数、そして最後にカスタム プロバイダー フォールバックをチェックします。 TokenHub のキーを models.yml に固定すると、古い OAuth よりも優先されます。これは、カスタム ベース URL に適しています。

最初のテストでは、tokenhub/YOUR_TOKENHUB_MODEL_ID を選択し、読み取り専用タスクを実行して、TokenHub ログを検査します。プロバイダーが存在しない場合は、YAML と disabledProviders を検査します。存在しても選択できない場合は、キーの解像度を調べてください。 401 の場合は、変数と authHeader を確認してください。 400 の場合は、機能とトークン制限を確認してください。

公式リファレンス

• omp: プロバイダー構成