get_creation_guidelines
Get creation guidelines and standards for SVG graphics and Markdown documents. This tool is a prerequisite for the save_resource tool and must be called before creating and saving any resources.
Use cases:
1. Get drawing standards before creating SVG visualizations
2. Get format requirements before creating Markdown documents
3. Get complete guidelines before batch resource creation
Usage recommendations:
1. Call this tool before starting any resource creation
2. Carefully read and follow the naming rules and directory structure
3. Create resources according to guidelines, then use save_resource tool
4. Recommended to save guidelines for team reference
Return data:
- data: Guidelines content
* guidelines: Guidelines text content
- File naming rules
- Directory structure requirements
- Format specifications
- Style guide
* type: Guidelines type (svg/markdown/all)
* version: Guidelines version
save_resource
Save AI-generated SVG graphics or Markdown documents to the knowledge graph. This tool must be used in conjunction with get_creation_guidelines and list_graphs tools.
Use cases:
1. Save SVG visualization representation of the graph
2. Save Markdown documents related to nodes
3. Batch save multiple resource files
Usage recommendations:
1. First call get_creation_guidelines to get resource creation standards
2. Use list_graphs to get target graph ID and node ID (if needed)
3. Create resource content according to standards
4. Use this tool to save the resource
5. After saving, use get_node_details to check resource association status
Return data:
- data: Saved resource information
* id: Resource ID
* type: Resource type (svg/markdown)
* title: Resource title
* description: Resource description
* nodeId: Associated node ID (if any)
* createdAt: Creation time
update_node
Modify nodes in the knowledge graph. This tool must be used in conjunction with list_graphs and get_node_details tools.
Use cases:
1. Update basic node information (name, description, etc.)
2. Update file paths associated with nodes
3. Update node metadata information
Usage recommendations:
1. First call list_graphs to get target graph and node ID
2. Use get_node_details to check current node status
3. Only update fields that need to be modified, keep others unchanged
4. After updating, call get_node_details again to confirm changes
Return data:
- data: Updated node information
* id: Node ID
* name: Node name
* type: Node type
* description: Node description
* filePath: Associated file path
* metadata: Node metadata
* updatedAt: Update time
update_edge
Modify edges in the knowledge graph. This tool must be used in conjunction with list_graphs and get_node_details tools.
Use cases:
1. Update edge label information
2. Adjust edge weight values
3. Update edge metadata information
Usage recommendations:
1. First call list_graphs to get target graph information
2. Use get_node_details to view edge list of related nodes
3. Only update fields that need to be modified, keep others unchanged
4. After updating, call get_node_details again to confirm changes
Return data:
- data: Updated edge information
* id: Edge ID
* type: Edge type
* sourceId: Source node ID
* targetId: Target node ID
* label: Edge label
* weight: Edge weight
* metadata: Edge metadata
* updatedAt: Update time
delete_node
Delete nodes from the knowledge graph. This tool must be used in conjunction with list_graphs tool, and the operation cannot be undone.
Use cases:
1. Delete incorrectly created nodes
2. Delete nodes that are no longer needed
3. Delete redundant nodes when restructuring the graph
Usage recommendations:
1. First call list_graphs to get target graph and node information
2. Use get_node_details to check node's associated resources and relationships
3. Confirm deletion won't affect other important nodes
4. Set confirmDelete to true to confirm deletion
5. Recommended to backup important data before deletion
Important notes:
- Deleting a node will also delete all edges related to that node
- If the node has associated resources, they won't be deleted but will be unlinked
Return data:
- data: Deletion result
* id: Deleted node ID
* name: Node name
* type: Node type
* deletedAt: Deletion time
delete_edge
Delete edges from the knowledge graph. This tool must be used in conjunction with list_graphs and get_node_details tools, and the operation cannot be undone.
Use cases:
1. Delete incorrectly created relationships
2. Update relationship structure between nodes
3. Clean up redundant relationships when restructuring the graph
Usage recommendations:
1. First call list_graphs to get target graph information
2. Use get_node_details to get edge details
3. Confirm deletion won't break important relationship structures
4. Set confirmDelete to true to confirm deletion
Important notes:
- Deleting edges won't affect related nodes
- Need to call get_node_details again to view updated relationships
Return data:
- data: Deletion result
* id: Deleted edge ID
* deletedAt: Deletion time
update_resource
Update resource information in the knowledge graph. This tool must be used in conjunction with list_graphs and get_node_details tools.
Use cases:
1. Modify resource title or description
2. Update resource metadata information
3. Improve resource documentation
Usage recommendations:
1. First call list_graphs to get target graph information
2. Use get_node_details to check current resource information
3. Only update fields that need to be modified
4. Maintain consistency in resource naming
Return data:
- data: Updated resource information
* id: Resource ID
* name: Resource name
* title: Resource title
* description: Resource description
* updatedAt: Update time
delete_resource
Delete resources from the knowledge graph. This tool must be used in conjunction with list_graphs and get_node_details tools, and the operation cannot be undone.
Use cases:
1. Delete outdated resource files
2. Clean up unnecessary documents
3. Remove incorrectly created resources
Usage recommendations:
1. First call list_graphs to get target graph information
2. Use get_node_details to confirm resource associations
3. Confirm deletion won't affect other nodes
4. Set confirmDelete to true to confirm deletion
5. Recommended to backup important resources before deletion
Important notes:
- Deleting a resource will also delete the physical file
- Will automatically unlink from all nodes
- This operation cannot be recovered
Return data:
- data: Deletion result
* id: Deleted resource ID
* type: Resource type
* deletedAt: Deletion time
unlink_resource
Unlink resource associations from nodes. This tool must be used in conjunction with list_graphs and get_node_details tools.
Use cases:
1. Adjust resource associations
2. Remove incorrect resource associations
3. Reorganize node resource structure
Usage recommendations:
1. First call list_graphs to get target graph information
2. Use get_node_details to view node's resource associations
3. Confirm unlinking won't affect other functionality
4. Record changes for potential re-association
Important notes:
- Only removes association, does not delete resource
- Resource can still be used by other nodes
- Association can be re-established at any time
Return data:
- data: Operation result
* resourceId: Resource ID
* nodeId: Node ID
* unlinkedAt: Time when association was removed