知识库 > TS-SKILL > SKILL.MD编写规范

Demo1:一个简单的SKILL功能说明示例:tinysoft-plus    

  • 当我们实现了这样了个SKILL:通过输入两个数值,计算这两个数值的和。

    我们可以这样编写它的SKILL说明:
    一般以md文档格式提供,.md文件可下载:附件:SKILL.md
    下面展示其内容:

    name: tinysoft-plus
    description: 调用天软TS-opi平台plus 函数,输出一个整数值。用于特殊测试场景计算a与b的和。当用户询问到了a、b总和时使用。

    参数说明
    参数类型条件说明示例
    aint选填整数类型,未传时 API 默认值为1515
    bint选填整数类型,未传时 API 默认值为100100

    返回字段:
    总和(int)
    调用行为约定
    - 如果用户未提供某个参数,不要传入该字段(留空不传),由 API 端自行处理
    - 禁止将未提供的参数默认填 0 或其他默认值
    调用配置
    需要知道以下正确信息才能正确调用工具:
    URL: https://opi.tinysoft.com.cn/Service/Session/Call/plus
    认证方式: Bearer Token (TOKEN从使用者处获取)
    必须HTTP头: 'Content-Type': 'application/json','JSON-Encode': 'gbk'
    请求体结构:{"a":a,"b":b} 或[a,b]
     -请求方式:POST