SuperAPI AI 工具集

typespec-create-agent

智能体与模型

查看项目

更新于 10-15 21:52

技能介绍

用途:根据用户需求生成一个完整的 TypeSpec 声明式智能体(Declarative Agent),面向 Microsoft 365 Copilot。

主要能力:生成 main.tsp 文件,包含 @agent 装饰器(名称不超过 100 字符,描述不超过 1000 字符)、@instructions 装饰器(定义角色、专长、性格及应做与不应做的事,不超过 8000 字符)、2 至 4 个 @conversationStarter 装饰器(各含标题与示例查询),以及按需选择的能力。可选能力包括 WebSearch、OneDriveAndSharePoint、TeamsMessages、Email、People、CodeInterpreter、GraphicArt、GraphConnectors、Dataverse、Meetings。

使用方式:先向用户询问智能体用途与角色、所需能力、知识来源、典型交互,再生成完整定义。模板需导入 @typespec/http、@typespec/openapi3、@microsoft/typespec-m365-copilot,并使用 TypeSpec.Http 与 TypeSpec.M365.Copilot.Agents 命名空间;能力以 op 形式写在 namespace 内,如 op capabilityName is AgentCapabilities.[CapabilityType]<[Parameters]>;。

最佳实践:使用描述性、基于角色的名称;指令用第二人称书写;明确专长与限制;开场白多样化;只包含实际需要的能力;尽量限定能力范围(URL、文件夹等);多行指令使用三引号字符串。

限制:资料未提供具体安装命令、收费方式、平台支持范围或实际运行效果说明。