suggest_document_path
Recommends a directory and file path for adding a document, based on sheet, row, and filename. Does not modify the file system; useful for previewing or planning document organization.
Instructions
Return recommended Directory and File for add_document.
Does not touch the file system. Use when organizing manually or to preview paths.
Args:
sheet_name: Target sheet (Component, Type, Space, etc.)
row_name: Target entity name
filename: File name
docs_root: Base folder for document organization (default 'docs')
Returns:
Dictionary with recommended directory and file paths
Example:
result = suggest_document_path(
sheet_name="Component",
row_name="AHU-1",
filename="manual.pdf"
)
# Returns: {"directory": "docs/Component/AHU-1", "file": "manual.pdf"}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filename | Yes | ||
| row_name | Yes | ||
| docs_root | No | docs | |
| sheet_name | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||