Scene

🤖 AI Drafted (Not reviewed)

Classify scene environment

Tool id	scene
Category	vision
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
Files (files)	files	yes	Image files
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).
force_ocr	boolean	no	Force image processing instead of existing text.
include_details	boolean	yes	Include scene details.
match_mode	string	prefer	Match mode. One of: prefer, strict, inform.
max_image_dimension	integer	8192	Max image size.
max_items	integer	10	List max items.
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.
scenes	array	[“indoor”, “outdoor_urban”, “outdoor_nature”, “studio”, “aerial”, “underwater”, “abstract”, “document”, “screenshot”]	Scene categories.
temperature	number	0.7	Creativity.
thinking_mode	string	off	Chain-of-thought reasoning depth. One of: off, short, medium, long.
vision_mode	string	auto	Vision engine. ‘auto’ picks based on the resolved provider: apple → Apple Vision OCR; anything else → LLM vision path. ‘kraken’ → on-device neural line segmentation (baselines/polygons, no text). One of: auto, apple, llm, kraken. (Not shown in the editor.)

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.

Classify the scene/environment in this image.

Choose ONE primary scene type from: indoor, outdoor_urban, outdoor_nature, studio, aerial, underwater, abstract, document, screenshot

Also describe:
- Lighting conditions (natural/artificial, bright/dim)
- Time of day if applicable (dawn/day/dusk/night)
- Weather if visible
- Setting details

Return as JSON:
{
    "scene": "<primary scene type>",
    "lighting": "<lighting description>",
    "time_of_day": "<if applicable>",
    "weather": "<if visible>",
    "details": "<brief setting description>"
}

Return ONLY valid JSON.