Actions13
Overview
The node integrates with the FastGPT AI customer service platform, specifically focusing on managing "collections" (datasets). The "获取集合详情" (Get Collection Details) operation retrieves detailed information about a specific collection within FastGPT. This is useful for users who want to programmatically access metadata or contents of a dataset stored in FastGPT, such as for further processing, analysis, or display.
Practical examples include:
- Fetching details of a knowledge base collection before updating or querying it.
- Retrieving metadata about a dataset folder to verify its contents or structure.
- Integrating collection details into automated workflows that manage AI training data or customer support resources.
Properties
| Name | Meaning |
|---|---|
| 父级目录ID | The ID of the parent directory/folder in FastGPT. Users can open a folder in FastGPT and copy this ID from the browser URL. Used to filter or locate collections under a specific folder. |
| 选择知识库 | Selects a knowledge base (dataset) from a dynamically loaded list filtered by the parent directory ID. The options are populated by fetching datasets of type "dataset" under the specified parent folder. |
| 集合ID | The unique identifier of the collection whose details are to be retrieved. Required for the "获取集合详情" and "删除一个集合" operations. |
Output
The node outputs JSON data containing the detailed information of the requested collection. This typically includes metadata fields such as the collection's name, ID, type, and possibly other descriptive attributes returned by the FastGPT API.
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential for authenticating with the FastGPT platform.
- The node sends HTTP requests to the FastGPT API base URL configured in the credentials.
- The "选择知识库" property depends on a POST request to
/core/dataset/listendpoint to dynamically load available datasets filtered by the parent directory ID.
Troubleshooting
Common issues:
- Invalid or missing collection ID (
集合ID) will result in failure to retrieve details. - Incorrect parent directory ID (
父级目录ID) may cause the knowledge base selection list to be empty or incorrect. - API authentication errors if the provided API key credential is invalid or expired.
- Network or connectivity issues preventing communication with the FastGPT API.
- Invalid or missing collection ID (
Error messages:
- Errors related to missing parameters usually indicate that required fields like
集合IDwere not set. - Authentication errors suggest checking the API key credential configuration.
- HTTP status errors might occur but are ignored by default (
ignoreHttpStatusErrors: true), so users should verify API responses carefully.
- Errors related to missing parameters usually indicate that required fields like
Links and References
- FastGPT Official Documentation (replace with actual URL if available)
- FastGPT API reference for dataset management (not publicly included in code, consult FastGPT docs)
- n8n documentation on creating custom nodes and handling dynamic options loading
Note: The node is designed to work within n8n workflows and requires proper configuration of credentials and input properties to function correctly.