SuperAPI AI 工具集

agently-model-setup

智能体与模型

查看项目

更新于 10-16 04:58

技能介绍

用途:该技能专注于模型提供方的接入与传输配置,适用于请求逻辑设计之前的准备工作,例如把模型端点、环境变量和设置文件接好。

主要能力与规则:默认采用异步优先思路,适用于服务、流式路径或并发工作流中调用已配置模型。设置存放在文件时,优先使用 Agently.load_settings("yaml_file", path, auto_load_env=True);内联映射或宿主覆盖可使用 Agently.set_settings(...) 或 agent.set_settings(...)。base URL、模型和认证信息建议通过设置文件中的 ${ENV.xxx} 占位符提供,并把提供方配置放在对应插件读取的命名空间下,OpenAICompatible 场景优先使用 plugins.ModelRequester.OpenAICompatible.*。若配置依赖 .env,应使用带 auto_load_env=True 的相应设置加载器。需要快速失败的应用,应在集成层先校验必需的环境变量名。加载后要验证实际生效的提供方、base URL、模型和认证是否存在,而非假定文件结构正确;提供方配置应与业务工作流逻辑和提示词文件分离。

限制与反模式:不要把特定提供方的解析硬编码进请求代码;在设置加环境变量占位符足够时,不要把密钥或环境相关端点写死在提交的 Python 代码中;不要将提供方配置放在活动插件不会读取的根级命名空间;不要让仅同步的示例决定可异步服务的架构;不要把模型设置与输出解析或工作流设计混在一起。更多内容见 references/overview.md。具体插件命名空间与加载细节以资料所述为限,其余暂未提供。