SuperAPI AI 工具集

agentform

智能体与模型

查看项目

更新于 10-15 19:58

技能介绍

用途:该技能用于创建和调试 Agentform 的声明式 AI 智能体配置(.af 文件),适用于新建 agentform 项目或工作流,以及排查 agentform 语法问题。

主要能力:支持多种块类型,包括 agentform(必需,含 version 与 project)、variable(变量,可标记 sensitive)、provider(格式为 provider "type.vendor" "name")、model、server(MCP 集成,支持 stdio 传输与 auth)、capability(含 side_effect 与 requires_approval)、policy(每个预算需独立 budgets {} 块,如 max_cost_usd_per_run、max_capability_calls、timeout_seconds)、agent(可设 model、fallback_models、policy、allow 与 instructions)以及 workflow。文件按字母顺序处理,建议用数字前缀命名(如 00-project.af、06-agents.af)。

使用方式:多行字符串使用 heredoc,结束标记必须位于第 0 列,否则解析失败。表达式支持引用(var.、provider.、model.、agent.、capability.、server.、policy.、step.)、工作流中的状态引用(input.、state.、result.)以及比较、逻辑和三元运算符,但不支持函数调用(如 contains()、length())。模型 ID 不应硬编码,需从提供商文档获取当前名称。CLI 命令包括 agentform validate --var api_key=$API_KEY 和 agentform run workflow_name --var api_key=$API_KEY --input '{"field": "value"}',可加 --verbose。

适用场景:构建基于 MCP 的智能体工作流,例如 GitHub PR 审查。模板可通过 cp -r ~/.claude/skills/agentform/assets/templates/simple-agent ./my-agent 等方式复制。

限制:资料未提供收费、价格、平台支持范围等信息;常见错误包括 heredoc EOF 缩进、使用函数调用、缺少运行时变量、MCP 包名错误等。