SuperAPI AI 工具集

architect-structured-procedures

通用与其它

查看项目

更新于 10-15 21:37

技能介绍

用途:创建、改写、检查或修复结构化(确定性)流程,也可在自由文本与确定性流程之间转换。两种形式都是一等公民,需刻意选择:free_form 为带可选 frontmatter 与散文步骤的 markdown,由模型判断执行,是默认且通常正确的选择;deterministic 为编译成真实状态机的 JSON,步骤严格按序执行,适合必须保证工具序列的场景(合规、工单规范、顺序不可变)。除非用户要求,否则不要互相转换;转换时需用一句话说明牺牲了哪种能力。

主要能力与用法:全部基于 ConvAI REST API(host https://api.elevenlabs.io,header xi-api-key: $API_KEY),需要 $AGENT_ID 与 $BRANCH_ID。创建与编辑遵循草稿后发布模型:create 提交草稿,edit 修补草稿,PATCH /v1/convai/agents/$AGENT_ID?branch_id=$BRANCH_ID 将待发布草稿发布为新版本。content 是仅含 trigger 与 steps 两个顶层键的 JSON 字符串,steps 非空。步骤类型包括 ask、tell、say、tool_call、system_tool、branch;branch 的 arm 含 condition 与 steps,condition 为 llm 或 expression,子步骤不可再嵌套 branch。on_failure 含 branches 与必填非空 fallback,fallback 子步骤可为 ask/tell/say/retry,retry 为 { "type": "retry", "max_retries": 1-3 }。

限制与校验:ask/tell 需非空 instruction,say 需非空 message;同一 branch 或失败处理器内条件类型必须一致,不可混用 llm 与 expression;retry 必须是其失败分支最后一步;end_call 出现处必须是最后一步;不可连续两个 branch 步骤;expression 条件不可紧接 ask 之后;tool_id 必须是该 agent 上真实工具,来自 GET /v1/convai/tools,不可臆造,tool_name 需匹配。不要猜测 schema,无 tool_code 步骤类型。发布前用 POST /v1/convai/agents/$AGENT_ID/branches/$BRANCH_ID/procedures/compile 校验,编译错误会指出路径(如 steps[2].tool_id),修正后重发一次。

自由文本转确定性:先 GET 读取当前 content、name、type,再 GET /v1/convai/tools 解析所有工具为真实 tool_id,按原顺序映射散文到步骤,然后 PATCH .../procedures/$PROCEDURE_ID/draft 并显式设置 type: "deterministic"。设置 type 即完成转换;省略 type 会沿用现有类型,仅编辑 content 无法转换。发布用 PATCH /v1/convai/agents/$AGENT_ID?branch_id=$BRANCH_ID,确认当前形式,并说明编辑在发布前仅存于分支草稿、合并后才生效。无法映射的步骤不可静默丢弃,须告知用户。