builtin__take

Keeps the first n items of a list, with no model call.

Behavior

• Returns the first n items; a shorter list is returned whole.

When to use it

• The top-k cut after builtin__sort. builtin__rank cuts its own result with top_k.

Available to	Effect
Any agent or plan step	Read-only

Input

items · any[] · required

The list, usually a template like {{E1.results}}

n · integer · required

How many items to keep

Output

items · any[] · required

Plan step

- id: E1
  tool_name: builtin__take
  input:
    items: "{{input.items}}"
    n: "{{input.n}}"