SuperAPI AI 工具集

agent-config

智能体与模型

查看项目

更新于 10-15 20:14

技能介绍

用途:将智能体可调参数从代码中外置为受版本控制的配置,便于统一管理与发布。

主要能力:Config Dataclass 是 opik.AgentConfig 的子类,字段需带类型注解且不设默认值;Blueprint 是某配置版本的不可变快照;Environment Tag(dev/staging/prod)指向某个 Blueprint;MaskID 是用于 A/B 测试的临时覆盖,由 Optimizer 使用。发布相同值会去重返回同一版本,不同值则创建新版本。

使用方式:定义配置类后调用 client.create_agent_config_version(MyConfig(...), project_name="my-project") 发布。运行时用 client.get_agent_config() 读取,且必须在 @opik.track 内调用,访问字段会把 agent_configuration 元数据注入 trace。选择器三选一:latest=True、env="prod" 或 version=v1;fallback= 在后端不可达时使用。用 cfg.deploy_to("prod") 打环境标签,可在 @track 外调用。字段可声明为 Prompt 或 ChatPrompt,通过 client.create_prompt()/create_chat_prompt() 创建,SDK 序列化版本 ID 并在读取时还原对象。Mask 覆盖由 Optimizer 与 Local Runner 透明处理,用户无需手动创建。

适用场景:需要按环境切换模型或采样参数、对提示词做版本管理、以及配合 Optimizer 做参数 A/B 测试的智能体项目。

限制:get_agent_config() 必须在 @opik.track 内调用;选择器必须且只能指定一个;配置字段不能有默认值;API 密钥、结构性逻辑与真正常量不应外置。具体收费与平台支持情况暂未提供。