SuperAPI AI 工具集

_project-context

智能体与模型

查看项目

更新于 10-16 06:47

技能介绍

用途:为在 Copilot Studio 代理项目中工作的所有子智能体提供共享上下文,统一项目结构、脚本用法与技能调用规范。

主要能力:

  1. 项目结构说明:代理目录通过 Glob **/agent.mcs.yml 自动发现,包含 agent.mcs.yml(代理元数据)、settings.mcs.yml(设置,如 schemaName、GenerativeActionsEnabled、instructions)、topics/(AdaptiveDialog YAML)、actions/(TaskDialog YAML)、knowledge/(KnowledgeSourceConfiguration YAML)、variables/(GlobalVariableComponent YAML)、agents/(子代理 AgentDialog YAML,各占子目录)。
  2. schema 查询脚本 ${CLAUDE_SKILL_DIR}/../../scripts/schema-lookup.bundle.js,支持 lookup、search、resolve、kinds、summary、validate 子命令,例如:node ${CLAUDE_SKILL_DIR}/../../scripts/schema-lookup.bundle.js lookup SendActivity。明确禁止加载完整 schema 文件 reference/bot.schema.yaml-authoring.json。
  3. 连接器查询脚本 ${CLAUDE_SKILL_DIR}/../../scripts/connector-lookup.bundle.js,支持 list、operations、operation、search,例如:node ${CLAUDE_SKILL_DIR}/../../scripts/connector-lookup.bundle.js operations <connector>。<connector> 可按 API 名(shared_office365)或显示名片段(outlook)匹配,用于查看动作的完整输入输出。
  4. 技能优先规则:YAML 创建、编辑、校验与测试应始终调用匹配技能,避免手动编写导致 kind 值臆造、必填字段缺失或 YAML 损坏;无匹配技能时才手动处理,并须用 /copilot-studio:validate 校验。
  5. 可用技能列表:new-topic、add-node、add-action、edit-action、add-knowledge、add-generative-answers、add-other-agents、add-global-variable、add-adaptive-card、edit-agent、edit-triggers、best-practices、validate、lookup-schema、list-kinds、list-topics、run-tests、chat-with-agent、known-issues。

关键约定:代理发现不硬编码名称;ID 为前缀加 6-8 位随机字母数字;模板 _REPLACE 占位符须替换为唯一随机 ID;Power Fx 表达式以 = 开头,字符串插值用 {},仅用受支持函数;GenerativeActionsEnabled: true 时使用主题输入/输出而非硬编码问答。

限制:具体调用方式与可用函数以官方资料为准,此处未提供进一步细节。