Skip to main content
Looks up rows in an agent-configured CSV by column match, exact or LLM-semantic. Display name “CSV Lookup”. Off by default — bind a CSV per configured tool. Prefer batch match_criteria / source_rows over one call per line item.

​
Authentication and enablement

Configured tool: upload/bind the CSV on the agent. No OAuth.

​
Inputs

  • file_name — which bound CSV.
  • match_criteria — [{column, values}]. Values in one criterion are OR; multiple criteria are AND. Columns by header, letter (A), or number (1).
  • return_columns — comma-separated names, or * (default).
  • matching_strategy — exact (fast) or llm (embeddings).
  • source_rows — for LLM matching on concatenated keys; pass per-row {column, value} pairs instead of hand-concatenating.
  • case_sensitive — exact match only; default false.

​
Output

Matched rows (and additional_candidates for LLM). The full CSV is not embedded — for a “pick any row” review UI, use review_form with a CSV option source.

​
Limits and side effects

  • LLM matching is slower/costlier; use exact when values are canonical.
  • Read-only against the bound CSV.

​
Expected errors

  • Unknown file_name, empty criteria (except LLM + source_rows), CSV still indexing.