Key People

🤖 AI Drafted (Not reviewed)

Identify important people

Tool id	key_people
Category	llm
Uses a language model	yes
Needs a generative model	no
Runs over many items	yes
Item handling	batch
Structured output	yes
Human-verified	not yet

What it reads

Port	Type	Required	What it is
Text (text)	text	yes	Source text or entity data
Context (context)	any	no	Previous text/transcription
Metadata (metadata)	json	no	Existing metadata
Documents (documents)	json	no	Document metadata

What it emits

Port	Type	Required	What it is
Text (text)	text	—	Raw text response
Value (value)	any	—	Parsed value
Texts (texts)	array	—	Per-item texts
Values (values)	array	—	Per-item values
Results (results)	json	—	Full results
Records (records)	array	—	Per-document text records [{doc_id, text}, …].
Artifacts (artifacts)	json	—	Artifact IDs

Options

Option	Type	Default	What it does
choices	array	—	Valid choices. (Not shown in the editor.)
chunk_size_chars	integer	0	Chunk large input text above this character budget (0=auto).
include_context	boolean	yes	Include role/context.
match_mode	string	prefer	Match mode. One of: prefer, strict, inform.
max_items	integer	10	List max items.
max_people	integer	10	Max people to identify.
max_tokens	integer	8192	Max response.
max_words	integer	50	Word limit.
metadata_field	string	—	Save to field.
model_name	string	—	Model name.
output_format	string	text	Response format. One of: text, boolean, choice, number, words, list, json.
prompt	string	—	Custom prompt.
provider_name	string	—	LLM provider. One of: openai, anthropic, google, ollama, lmstudio, groq, together, deepseek, mistral, openrouter, dashscope, xai, perplexity, fireworks, deepl.
quality_gate	boolean	yes	Stop the run if output is unreadable.
reference_values	object	—	Known values to match. (Not shown in the editor.)
save_to_db	boolean	yes	Save to library.
save_to_file	boolean	no	Export to file.
temperature	number	0.7	Creativity.
thinking_mode	string	off	Chain-of-thought reasoning depth. One of: off, short, medium, long.

The prompt it sends

This is what the tool asks a model, with every option left at its default. Changing the options above changes this text.

Identify the 10 most important people mentioned in this text.

Rank them by importance to the overall narrative/content.

For each person, include:
- Their role or title if mentioned
- Their importance to the narrative (what they did)
- Relationships to other key people

Return as JSON:
{
    "key_people": [
        {
            "name": "<full name>",
            "role": "<title or role>",
            "importance": "<why they are important>",
            "alternative_names": ["<any other names/spellings used>"]
        }
    ],
    "total_people_found": <total people mentioned in text>
}

Return ONLY valid JSON.