Docs

Tools: observability

2 tool(s) in this category.

operation.get

Get Operation

Fetch metadata for a single operation by its dotted id (e.g. data.cluster_search, artifacts.create, context.summary). Read when a tool picker needs to render the typed input form for a specific op or when an agent_blueprint llm step references an op id. Returns the lean projection (id, namespace, name, description, kind, sensitivity, required_scopes, input_schema). Returns null when the id is not registered.

  • HTTP: GET /operations/:id
  • Required scopes: artifacts:read
  • Required role: viewer
  • Stability: stable
  • Version: 1.0

Input

FieldTypeRequiredDescription
idstringyes

operation.list

List Operations

List every operation registered in the unified operation registry, grouped by namespace (data, artifacts, context, conversations, etc.). Read when authoring an agent_blueprint or rendering a tool picker so the catalog stays registry-driven (167+ operations) instead of hardcoded. Optional filters: ?namespace, ?kind=read|write|compute|workflow, ?include_admin=false (default false).

  • HTTP: GET /operations
  • Required scopes: artifacts:read
  • Required role: viewer
  • Stability: stable
  • Version: 1.0

Input

FieldTypeRequiredDescription
namespacestringno
kind`enum("read""write""compute"
include_adminstringno