FastGPT icon

FastGPT

AI智能客服平台

集合 → 更新集合信息

AI-generated

Summary

Updates a FastGPT dataset collection's metadata (name, tags, parent folder, disabled flag, creation time) by POSTing to /core/dataset/collection/update. The collection is identified either by collection ID or by dataset ID plus external file ID.

Inputs

  • 集合ID (updateCollectionId) — ID of the collection to update, sent as id. Use this or the dataset ID + external file ID pair.
  • 知识库ID (updateDatasetId) — Dataset (knowledge base) ID, sent as datasetId. Used together with the external file ID as an alternative to the collection ID.
  • 外部文件ID (updateExternalFileId) — External file ID, sent as externalFileId. Needs the dataset ID.
  • 父级ID (updateParentId) — Moves the collection to a new parent folder. Per the description, leaving it empty means no change.
  • 名称 (updateName) — New collection name. Per the description, leaving it empty means no change.
  • 标签 (updateTags) — Comma-separated tags (e.g. tag1,tag2), trimmed and sent as an array. If empty, the tags are not converted to an array.
  • 禁用状态 (updateForbid) — Boolean, default false. Sent as forbid to disable the collection. It is always sent, so leaving it at false may re-enable a disabled collection.
  • 创建时间 (updateCreateTime) — New creation time in ISO format, e.g. 2024-01-01T00:00:00.000Z. Per the description, leaving it empty means no change.
  • Request Options — Optional batching, SSL-ignore, proxy and timeout (default 10000 ms) settings.

Output shape

The parsed JSON response from FastGPT's collection update endpoint, one item per input item.

HTTP 4xx/5xx statuses, or a response body code other than 200, throw a NodeApiError carrying the response message. Empty-string fields are still sent in the body, so whether they are ignored depends on the FastGPT server.

Examples

Example 1: Rename a collection and tag it

集合ID = abc123, 名称 = 'Product FAQ', 标签 = 'faq,v2'

Example 2: Disable a collection synced from an external system

知识库ID = , 外部文件ID = , 禁用状态 = true

Example 3: Move a collection into another folder

集合ID = abc123, 父级ID =

Links

Discussion