FastGPT icon

FastGPT

AI智能客服平台

对话 → 获取历史记录列表

AI-generated

Summary

Fetches a paginated list of chat history entries for a FastGPT app via POST /core/chat/history/getHistories, optionally filtered by conversation source.

Inputs

  • 应用ID (historyAppId) (required) — FastGPT App ID whose chat histories are listed. Sent as appId in the request body.
  • 偏移量 (historyOffset) — Zero-based index of the first record to return. Default 0. Sent as offset.
  • 每页数量 (historyPageSize) — Number of records per page. Default 20. Sent as pageSize.
  • 对话源 (historySource) — Source filter. Default api, which returns only conversations created through the API. Sent as source.
  • Request Options — Optional node settings: batching (items per batch and interval), ignore SSL issues, proxy, and timeout (default 10000 ms).

Output shape

The parsed JSON response from the FastGPT API, containing the list of chat history entries for the app.

The exact response fields come from the FastGPT server, not the node. The node throws a NodeApiError if the HTTP status is 4xx or 5xx, or if the response body code is not 200. It uses the body's message as the error message. Page through results by increasing the offset.

Examples

Example 1: List the 20 most recent API-created conversations for an app

应用ID = your App ID; 偏移量 = 0; 每页数量 = 20; 对话源 = api

Example 2: Fetch the second page of 50 histories

应用ID = your App ID; 偏移量 = 50; 每页数量 = 50; 对话源 = api

Links

Discussion