mcpField
A
agently-model-setup

agently-model-setup

github.com/agentera开发3143 次安装4 天前更新
代码仓库

关于 agently-model-setup

为 Agently 配置模型提供方和传输方式的技能，适用于编写请求或工作流逻辑之前。它侧重异步优先、环境变量配置及加载后的设置核验。

主要功能

  1. 01异步优先的配置建议
  2. 02从文件或映射加载设置
  3. 03使用环境变量占位符
  4. 04核验提供方配置

适用场景

  1. 01为并发服务配置模型
  2. 02避免将凭据写入代码库
  3. 03加载后检查提供方设置

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/agentera/agently-skills --skill agently-model-setup

安装后在 Claude Code 中输入/agently-model-setup确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

examples/
.gitkeep
minimal.py
outputs/
.gitkeep
expected.md
references/
overview.md
scripts/
check.py

详细介绍

Agently 模型设置

在讨论请求逻辑之前，使用本技能完成 provider 接入与传输层设置。

原生优先规则

  • 当配置的模型将被服务、流式路径或并发工作流使用时，默认采用 async-first 的指导方式
  • 当设置保存在文件中时，优先使用 Agently.load_settings("yaml_file", path, auto_load_env=True)
  • 对于内联映射或宿主自有的覆盖配置，使用 Agently.set_settings(...) 或 agent.set_settings(...)
  • 优先使用带有 ${ENV.xxx} 占位符的设置文件来配置 base URL、模型和认证
  • 将 provider 设置放在由所属插件读取的命名空间下。对于 OpenAICompatible，优先使用 plugins.ModelRequester.OpenAICompatible.*
  • 当配置内容可能依赖 .env 时，调用匹配的设置加载器并传入 auto_load_env=True
  • 如果应用必须快速失败，请在调用 Agently 之前于集成层校验必需的环境变量名称
  • 加载完成后，验证实际生效的 provider 激活状态、base URL、模型和认证是否存在，而不是假设文件结构是正确的
  • 将 provider 设置保持在业务工作流逻辑和提示词文件之外

反模式

  • 不要将 provider 特定的解析逻辑硬编码到请求代码中
  • 当设置加环境变量占位符已经足够时，不要将密钥或环境特定的端点硬编码到已提交的 Python 代码中
  • 不要将 provider 配置留在当前激活插件不会读取的根级命名空间下
  • 不要让仅支持同步的示例决定具备异步能力的服务的架构
  • 不要将模型设置与输出解析或工作流设计混在一起

接下来阅读

  • references/overview.md

评论

支持 Markdown