Agent — CLI Command¶

Usage¶

momentry agent <TOOL> '<JSON_ARGS>'

Description¶

Run an agent tool directly from CLI with JSON arguments. Same interface as LLM function calling.

Arguments¶

Argument	Type	Required	Description
`TOOL`	string	Yes	Tool name (find_file, list_files, tkg_query, etc.)
`ARGS`	string	Yes	JSON arguments for the tool

Available Tools¶

Tool	Description
`find_file`	Search files by keyword
`list_files`	List recent files
`tkg_query`	Query TKG (top_identities, speaker_dialogue, etc.)
`tkg_nodes_query`	Query TKG nodes
`tkg_edges_query`	Query TKG edges
`tkg_node_detail`	Query single TKG node
`smart_search`	Semantic search chunks
`identity_text`	Search text to find identities
`identities_search`	Search identity dialogue
`get_identity_detail`	Get identity details
`get_file_info`	Get file metadata
`get_representative_frame`	Get representative frame
`analyze_frame`	Analyze frame with vision LLM

Examples¶

# List recent files
momentry agent list_files '{}'

# Find files by keyword
momentry agent find_file '{"query":"batman"}'

# Get file info
momentry agent get_file_info '{"file_uuid":"384b0ff44aaaa1f1"}'

# Query top identities
momentry agent tkg_query '{"file_uuid":"384b0ff44aaaa1f1","query_type":"top_identities"}'

# Smart search
momentry agent smart_search '{"query":"action scene","limit":5}'

# Analyze frame
momentry agent analyze_frame '{"file_uuid":"384b0ff44aaaa1f1","question":"What is happening?"}'

Agent Callable¶

Format: Direct CLI invocation — agent tools are designed for this.

Returns: JSON string with tool results.

query — Basic RAG query
tkg_query — TKG API endpoint
smart_search — Search API endpoint