操作说明_大模型服务平台百炼-阿里云帮助中心

插件是智能体API应用中重要的一环，结合增强大语言模型的规划调度能力和生成能力，更好地在您的业务场景中落地。我们提供两类插件：官方插件和自定义插件

官方插件

百炼平台官方提供的插件，您可以根据业务需求进行选择。

官方插件名称	插件说明	收费情况
图片生成	接入图片生成插件使通义千问大模型拥有良好的文生图、图文生图的能力。	限时免费，需申请开通
夸克搜索	接入夸克搜索插件来查找公开的网络知识和信息，增强大模型对实时信息的获取能力。该插件能力由夸克团队提供。	限时免费
Python代码解释器	接入代码解释器插件使通义千问大模型拥有执行Python代码的能力，可用于数学计算、数据分析与可视化、数据处理等任务。	免费
计算器	接入计算器插件使通义千问大模型拥有良好的计算能力，可用于教育等应用场景。	免费

说明

百炼官方插件目前均免费提供给用户使用，部分插件后续可能会收费。

自定义插件

您可以根据业务需求注册自定义插件，并在智能体API应用中选择使用这些插件。自定义插件的配置方式如下：

1、创建自定义插件

在插件中心-自定义插件中，点击“新建自定义插件”按钮，进入插件创建页面。

2、填写插件信息

在自定义插件中，编辑插件信息，包括：

插件名称：自定义插件的名称。
插件ID：建议您输入具有语义的英文名称，例如：search、weather等。在您点击“创建完成”后，系统将为您生成全局唯一的插件ID。

说明

您可以在Assistant API中使用该插件ID调用您的自定义插件。

插件描述：请使用自然语言描述插件的功能，尽量给出使用示例。例如：“此插件用于获取指定时间和指定地点的天气和温度。例如杭州明天是否下雨”。 API时，请使用系统最终生成的ID。
是否鉴权：当百炼调用您的自定义插件时是否进行鉴权，系统支持无鉴权、服务级鉴权和用户级鉴权三种方式。

两种鉴权方式的详细说明如下：

服务级鉴权：您的所有终端用户调用时使用相同的Token。
- 位置：支持将鉴权信息放在Header和Query中。
  - Header：将鉴权信息放在HTTP请求头列表中，这些信息在URL中不可见。
  - Query：将鉴权信息放在URL中，例如https://example.com?api_key=123456。
- 参数名：您系统鉴权时使用的参数，如“Authorization”。
- Type：支持basic和bearer两种，区别是basic不会在您提供的token前加任何内容，bearer则会在token前增加“Bearer ”，两种type都会放在Authorization字段中。例如：选择bearer，则调用插件时会变成（“Authorization”： “Bearer your_token”）。
- Token：您的鉴权token。

用户级鉴权：您的终端用户的Token，适用于对每个终端用户进行鉴权。
- 位置：同服务级鉴权。
- Type：同服务级鉴权。

3、填写接口信息

在代码框中定义您的接口信息，我们支持OpenAPI v3协议来提供对于插件接口的描述。关于OpenAPI v3的详细字段，您可以参见：OpenAPI v3.0.3。详细写法请参考：如何定义插件接口协议。

以下是系统默认提供的参考示例。

openapi: 3.0.1
info:
    title: 寝室公约查询工具
    description: 寝室公约查询工具，可以根据序号查询特定条目。
    version: "v2"
servers:
    - url: https://domitorgreement-plugin-example-icohrkdjxy.cn-beijing.fcapp.run
paths:
    /article:
        post:
            operationId: get_article
            summary: 查询寝室公约第几条，用整数数字
            requestBody:
                required: true
                content:
                    application/json:
                        schema:
                            type: object
                            required: [article_index]
                            properties:
                                article_index:
                                    type: integer
                                    description: 寝室公约第几条，用整数数字
            responses:
                "200":
                    description: 查询成功
                    content:
                        application/json:
                            schema:
                                type: object
                                required: [article]
                                properties:
                                    article:
                                        type: string
                                        description: 寝室公约条款