Assistants

创建智能体

创建一个新的智能体（Assistant）。

POST

/assistants

cURL

curl --request POST \
  --url 'https://dashscope.aliyuncs.com/api/v1/assistants' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "qwen-max",
  "name": "智能小助手",
  "description": "这是一个智能小助手",
  "instructions": "你是一个智能小助手，你可以根据用户的需求去调用不同的工具，进而给出回答。请酌情使用工具。",
  "tools": [
    {
      "type": "code_interpreter"
    }
  ],
  "metadata": {}
}
'

{
  "id": "asst_49079f4b-d1e8-4015-a12e-2dcdd1f18d84",
  "object": "assistant",
  "created_at": 1711713885724,
  "model": "qwen-max",
  "name": "智能小助手",
  "description": "这是一个智能小助手",
  "instructions": "你是一个智能小助手，你可以根据用户的需求去调用不同的工具，进而给出回答。请酌情使用工具。",
  "tools": [
    {
      "type": "code_interpreter"
    }
  ],
  "metadata": {},
  "temperature": null,
  "top_p": null,
  "top_k": null,
  "max_tokens": null,
  "request_id": "b1778226-3865-9006-9e95-56329a710322"
}

Authorizations

string

header

required

DashScope API Key，在控制台 API Key 页面（https://bailian.console.aliyun.com/settings/apikey）获取。请求头格式：Authorization: Bearer $DASHSCOPE_API_KEY。

Body

application/json

string

required

智能体所使用的模型。

string

智能体使用的名字。

string

用于描述智能体的文字。

string

System prompt，用于智能体里的大模型。

object[]

一个可以被智能体调用的 tools 列表。自定义插件可通过 type 与 auth（用户级鉴权）传递。

object

其他相关参数，用于存储智能体的附加信息。

number

用于控制随机性和多样性的程度。

number

生成时，核采样方法的概率阈值。

integer

生成时，采样候选集的大小。

Response

200-application/json

cURL

curl --request POST \
  --url 'https://dashscope.aliyuncs.com/api/v1/assistants' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "qwen-max",
  "name": "智能小助手",
  "description": "这是一个智能小助手",
  "instructions": "你是一个智能小助手，你可以根据用户的需求去调用不同的工具，进而给出回答。请酌情使用工具。",
  "tools": [
    {
      "type": "code_interpreter"
    }
  ],
  "metadata": {}
}
'

{
  "id": "asst_49079f4b-d1e8-4015-a12e-2dcdd1f18d84",
  "object": "assistant",
  "created_at": 1711713885724,
  "model": "qwen-max",
  "name": "智能小助手",
  "description": "这是一个智能小助手",
  "instructions": "你是一个智能小助手，你可以根据用户的需求去调用不同的工具，进而给出回答。请酌情使用工具。",
  "tools": [
    {
      "type": "code_interpreter"
    }
  ],
  "metadata": {},
  "temperature": null,
  "top_p": null,
  "top_k": null,
  "max_tokens": null,
  "request_id": "b1778226-3865-9006-9e95-56329a710322"
}

创建智能体 - Agent Studio