Enum AgentModelRef 

pub enum AgentModelRef {
    Inherit,
    ById {
        model_id: ModelId,
        provider_id: ProviderId,
    },
    ByAlias {
        alias: String,
    },
}

模型引用 — 轻量级标识，运行时解析为完整 ModelRef。

Agent 定义中不直接持有 API key、base_url 等敏感信息， 而是通过引用方式在运行时由 ModelResolver 解析。

Examples

use katu_core::{AgentModelRef, ModelId, ProviderId};

// 继承调用者的模型
let inherit = AgentModelRef::Inherit;

// 按 ID 指定
let specific = AgentModelRef::by_id(
    ModelId::new("gpt-4o"),
    ProviderId::new("openai"),
);

// 按别名（如 "fast", "strong", "cheap"）
let alias = AgentModelRef::by_alias("fast");

Variants

Inherit

继承父 Agent / 调用者的模型配置。

ById

按 ID 精确指定模型和 provider。

Fields

model_id: ModelId

provider_id: ProviderId

ByAlias

按别名引用（运行时由配置映射到具体模型）。

Fields

alias: String

Implementations

impl AgentModelRef

pub fn by_id(model_id: ModelId, provider_id: ProviderId) -> Self

创建按 ID 指定的模型引用。

pub fn by_alias(alias: impl Into<String>) -> Self

创建按别名指定的模型引用。

Trait Implementations

impl Clone for AgentModelRef

fn clone(&self) -> AgentModelRef

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AgentModelRef

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentModelRef

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for AgentModelRef

fn eq(&self, other: &AgentModelRef) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AgentModelRef

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for AgentModelRef

impl StructuralPartialEq for AgentModelRef