Model Resolution

Vela SDKは互換入力を残しつつ、新規実装では Model Slot と capability-based requirement を中心に扱います。

入力	推奨度	用途
modelSlot	推奨	アプリ内の用途単位を表す。lockedまたはuser-selectable。
modelRequirement	推奨	capability、modality、compatible models、preferenceで柔らかく要求する。
modelRequest	互換	exactまたはordered candidates。既存実装向け。
requestedModel	互換	1つのmodel idを直接渡す古い入力。

locked Model Slot

import { createLockedModelSlot } from "@vel4ai/sdk";

export const chatSlot = createLockedModelSlot("openai/gpt-4o-mini", {
  slotId: "chat",
  label: "チャット応答",
});

user-selectable Model Slot

import { createUserSelectableModelSlot } from "@vel4ai/sdk";

export const assistantSlot = createUserSelectableModelSlot(
  ["openai/gpt-4o-mini", "anthropic/claude-3.5-sonnet"],
  {
    slotId: "assistant",
    label: "アシスタント応答",
    recommendedModels: ["openai/gpt-4o-mini"],
  },
);

capability-based requirement

import { createCapabilityModelRequirement } from "@vel4ai/sdk";

export const textReasoningRequirement = createCapabilityModelRequirement({
  capabilities: ["model:openai/gpt-4o-mini", "model:anthropic/claude-3.5-sonnet"],
  modalities: ["text"],
  preference: "balanced",
});

modelResolution を見る

readiness、non-allow response、allowed executionには modelResolution が入ることがあります。UIやlogでは、選ばれたmodel、filtered reason、allowedModelsとの差分をここから説明できます。