SEARCH WORKFLOW CORPUS¶
Provides read-only search and inspection access to the full workflow corpus — the user’s saved workflows and the platform library — so an AI agent can pull structural reference patterns before assembling a new workflow. Exposes four commands: search (free-text → ranked metadata), summary (workflow-level shape), get_subgraph (subgraph centered on a node, N hops), and get_node (single-node detail with wiring).
When to use¶
Tagged: agent_tool, ai_agent, graph_search, library, multi_command, node_detail, read_only, search.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Command | command | text | search | Selects the operation to perform; one of search, summary, get_subgraph, or get_node. Defaults to search when omitted. | |
| Query | query | text | — | Free-text search string used by command=search; tokenized and scored against workflow names, worker types, and descriptions. Required when command is search. | |
| Source | source | text | both | Corpus scope to query: user (saved workflows), library (platform library at data/workflows/), or both. Defaults to both for search and library for targeted commands (summary, get_subgraph, get_node). | |
| Max Results | max_results | scalar | 5 | Maximum number of ranked hits returned by command=search; integer in [1, 50], defaults to 5. Ignored for all other commands. | |
| Workflow Id | id | text | — | Workflow identifier to inspect; required for summary, get_subgraph, and get_node. Library IDs are 3-digit strings (e.g. 912); user workflow IDs are database integers. | |
| Focus Node Id | focus_node_id | text | — | Specific node ID used as the subgraph anchor for command=get_subgraph. Mutually exclusive with focus_node_type; supply when the exact node ID is known. | |
| Focus Node Type | focus_node_type | text | — | Worker type string (e.g. curve_stats) used as the subgraph anchor for command=get_subgraph when the specific node ID is unknown; all nodes of this type become focus points. | |
| Hops | hops | scalar | 1 | Neighborhood radius for command=get_subgraph; integer in [1, 3], defaults to 1 (direct neighbors only). Larger values return broader context but more nodes. | |
| Node Id | node_id | text | — | Node ID within the target workflow to retrieve; required for command=get_node. Returns full input/output wiring detail for that single node. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| Results | results | json | JSON payload whose shape varies by command: search returns ranked hits with score, matched node types, and worker count; summary returns workflow-level statistics (worker/edge count, types present, branch shape, START inputs); get_subgraph returns the node+edge subgraph around the focus node(s); get_node returns full input/output wiring and upstream/downstream neighbor IDs for a single node. |
| Status | status | string | Human-readable one-line summary of the operation result, e.g. the number of workflows scanned and matched for a search, or the subgraph size and hop radius for a get_subgraph call. Useful for agent logging and debugging. |
Disciplines¶
- ai_ml.agents
- ai_ml.domain_reasoning
- platform.workflow
Auto-generated from platform schema. Worker id: workflow_corpus_search. Schema hash: 914c5085de2c. Hand-curated docs in workerexamples/ override this page when present.