| Tool | When to use |
|---|---|
search_artifacts | Hybrid semantic + lexical search across artifact text. Returns ranked results with short context snippets. Start here for artifact discovery. |
get_artifact_details | Full metadata for a single artifact by resource_key — type, status, file info, and linked artifacts (input_artifacts, output_artifacts, children). |
get_artifact_content | Full or range-mode text extraction for a single artifact. Use range mode (start_line / end_line) when you need to cite specific lines. |
search_artifact_text | Within one artifact (by resource_key), find line-numbered matches with surrounding context. Regex or literal. There is no cross-document text search on the external surface — for multi-document retrieval, use search_artifacts. |
Common chains
- Cite a passage:
search_artifacts→get_artifact_contentwith a line range → quote the lines back to the user - Read a full SOP:
search_artifacts(find by query) →get_artifact_content(full text) - Search inside one artifact:
search_artifacts(find the artifact) →search_artifact_text(locate specific mentions by regex or literal) - Trace lineage:
get_artifact_details→ walkinput_artifacts/output_artifacts/childrento find related sources