Skip to content
Flow Like logo Flow Like Docs

LLM Rank Candidates Node

Automation/LLM/Vision

Uses LLM to rank multiple element candidates based on match quality

llm_rank_candidatesautomationLong running
Inputs8
Outputs4
Security exposure4/10
Packageautomation

Ratings

Scores range from 0 to 10. Higher values mean more impact, exposure, or operational weight.

SecurityAttack surface and exposure impact.
4/10Medium
PrivacyPotential sensitivity of processed data.
3/10Low
PerformanceRuntime or resource pressure.
4/10Medium
GovernancePolicy, audit, or compliance impact.
5/10Medium
ReliabilityOperational stability considerations.
7/10High
CostExternal or compute cost impact.
5/10Medium

Input Pins

8

▶

Execution
exec_in

Trigger

Model

Struct
model

Vision-capable LLM model

BitBit19 fields
idstring
default ""
typeBitTypes
enum "Llm", "Vlm", "Tts", "Stt"...default "Other"
metaMap<string, Metadata>
default {}
*Metadatamap value
namestringrequired
descriptionstringrequired
long_descriptionstring | null
release_notesstring | null
tagsArray<string>required
itemsstringarray item
+11 more fields
authorsArray<string>
default []
itemsstringarray item
repositorystring | null
default null
download_linkstring | null
default null
file_namestring | null
default null
hashstring
default ""
sizeinteger | null
format uint64default nullmin 0
hubstring
default ""
parametersvalue
default null
versionstring | null
default null
licensestring | null
default null
dependenciesArray<string>
default []
itemsstringarray item
dependency_tree_hashstring
default ""
createdstring
default ""
updatedstring
default ""
model_slugstring | null
default null
+1 more fields
Schema enforced

Screenshot

String
screenshot

Screenshot as base64 PNG, JPEG, WebP or GIF (a data URL is fine). Ignored when Image is connected

Image

Struct
image

Screenshot as an image, e.g. from the Screenshot node. Takes precedence over the base64 Screenshot

NodeImageNodeImage1 fields
image_refstringrequired

Frame

Struct
frame

Screen frame of the screenshot, from the capture node. Coordinates are desktop input coordinates (ready for the mouse nodes) when Frame is connected, otherwise pixels of the original screenshot

ScreenFrameScreenFrame7 fields
display_indexinteger | null
format uint32default nullmin 0
xinteger:int32required
format int32
yinteger:int32required
format int32
widthinteger:uint32required
format uint32min 0
heightinteger:uint32required
format uint32min 0
pixel_widthinteger:uint32required
format uint32min 0
pixel_heightinteger:uint32required
format uint32min 0

Candidates

Struct Array
candidates

Candidate elements to rank, each with a unique id. Optional x/y are in desktop input coordinates (ready for the mouse nodes) when Frame is connected, otherwise pixels of the original screenshot

CandidateInputCandidateInput6 fields
idstringrequired
descriptionstringrequired
xinteger | null
format int32
yinteger | null
format int32
selectorstring | null
additional_infostring | null

Criteria

String
criteria

What the target element should match (description/intent)

Context

String
context

Additional context for ranking

Output Pins

4

▶

Execution
exec_out

Continue

Result

Struct
result

Full ranking result; only given candidate ids appear

RankingResultRankingResult4 fields
ranked_candidatesArray<RankedCandidate>required
itemsRankedCandidatearray item
idstringrequired
rankinteger:uintrequired
format uintmin 0
scorenumber:doublerequired
format double
reasoningstringrequired
is_recommendedbooleanrequired
best_match_idstringrequired
confidencenumber:doublerequired
format double
ambiguity_warningstring | null

Best Match

String
best_match

ID of the best matching candidate

Ranked

Struct Array
ranked

Candidates sorted by rank

RankedCandidateRankedCandidate5 fields
idstringrequired
rankinteger:uintrequired
format uintmin 0
scorenumber:doublerequired
format double
reasoningstringrequired
is_recommendedbooleanrequired

Node Info

Internal name
llm_rank_candidates
Category
Automation/LLM/Vision
Version
5