---
title: "助手列表"
method: POST
path: "/paas/v4/assistant/list"
tags: ["助理 API"]
deprecated: true
---

# 助手列表

`POST /paas/v4/assistant/list`

## Request

- Base URL: `https://open.bigmodel.cn/api`
- URL: `https://open.bigmodel.cn/api/paas/v4/assistant/list`
- Auth: HTTP bearer

> **Deprecated.**

查询指定的智能体助手列表信息，包括智能体助手的详细配置、工具和元数据。点击 **Try it** 按钮可快速试用。

## Request body

- AssistantListRequest
  - `assistant_id_list` string[], required: 智能体`ID`列表，如果为空则查询所有可用智能体

## Response `200`

业务处理成功

- object
  - `success` boolean
  - `code` integer
  - `msg` string
  - `data` AssistantInfo[]
    - `assistant_id` string, required: 智能体`ID`
    - `name` string, required: 智能体名称
    - `avatar` string: 智能体头像URL
    - `description` string: 智能体描述
    - `tools` string[]: 智能体支持的工具列表
    - `tags` object[]: 智能体标签列表
      - `key` string: 标签键
      - `label` string: 标签值
    - `status` string: 智能体状态
    - `starter_prompts` object[]: 智能体的起始提示语
    - `created_at` string: 创建时间
    - `updated_at` string: 更新时间

## Other responses

- `default`: 请求失败。

## Changes

- **2026-11-03** `7fd61aa7f811`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/changes/paas/v4/assistant/list/post.md)

---

[API](https://skmtc.dev/bigmodel/apis/zhipu-ai-api.md) - [All operations](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/revisions/f2be7c0fcbb9?raw)