接入概览

在编程工具、Agent CLI 和业务客户端中接入 Modelink 时,你需要重点确认配置项、权限边界和使用方式。

核心配置

无论是 VS Code 插件生态、OpenCode、Claude Code、Codex、Hermes Agent、OpenClaw,还是业务客户端,通常都围绕三项配置展开:

配置项说明
Base URLModelink 接入点;中国大陆 https://api.qnaigc.com,海外 https://api.modelink.ai;OpenAI 兼容工具通常追加 /v1,Anthropic 兼容工具通常不带 /v1
API Key在 Modelink 控制台获取,建议通过环境变量或本地安全配置传入
Model ID工具或客户端实际调用的 Modelink 模型标识

编程工具配置入口

编程工具使用边界

编程工具可参与代码阅读、生成、重构、测试、审查和开发环境操作。接入时建议:

  • 为个人、团队或项目配置独立 API Key,便于追踪用量和权限。
  • 明确工具可读取和修改的仓库、目录和文件类型。
  • 写入代码前展示变更摘要或 diff。
  • 推送分支、创建 PR、发布版本、变更 CI/CD 前要求人工确认。
  • 运行测试、类型检查或构建验证后再提交。
  • 对高风险命令设置审批、沙箱或只读模式。
  • .env、密钥文件、生产配置、客户数据目录设置默认拒绝读取策略。
  • 修改配置后完整重启工具,并使用工具内状态命令或配置检查命令确认 Base URL、API Key 和模型是否生效。

普通对话与 Agent 的区别

维度普通对话Agent
工作方式被动回答问题主动拆解并执行任务
能力范围文本生成和理解为主可调用工具、系统和数据源
任务复杂度单步任务多步骤、长流程任务
自主性需要明确指令可规划步骤并根据结果调整
治理要求关注回答质量额外关注权限、审计和人工接管

Agent 治理建议

Agent 一旦具备工具调用能力,就可能读取文件、访问网络、执行命令或触发业务动作。建议从只读、低风险能力开始,再逐步开放写入、外发、生产变更等高风险动作。上线前应明确工具权限、审计记录、人工接管和降级策略,具体生产治理可参考 生产最佳实践

信息

工具接入建议先跑通低风险场景,再根据团队权限策略逐步扩大能力范围。