> Public product help. This page has no customer entries, projects, chat transcripts, API keys, or horizon contents.
> Reading that data requires `Authorization: Bearer` (a signed-in app session JWT, or a Headless access token).
> Do not call Supabase `/rest/v1` with a Headless JWT. Data reads go through `/casc/v1/headless/v1/rest`.

# Search Fields and Raw Keys

Vector search tools read from **entries** in linked ingestion groups. Each entry stores a `raw` JSON object plus optional processed output keys.

## Raw vs output keys

| Path style | Source | Example |
| --- | --- | --- |
| `raw.fieldname` | Column mapping, API mapping, manual entry | `raw.body`, `raw.company_name` |
| `file.file` | Processed file content key | Extracted document text |
| Output keys | Prompt pipeline writes | Enriched summaries without `raw.` prefix when registered |

## Column mapping on groups

Spreadsheet and API groups declare **column mapping**: source column → `raw` slug. Tool configuration must reference slugs that exist on entries. Product docs use slugs like `body`, `title`, `section` → tool field `raw.body`.

## Files and filenames

- Uploaded or Drive-ingested files store content under keys like `raw._file_<id>`.
- Searchable filename: `raw.file_filename` or group-specific slug.
- For document search, set search field to extracted text (`file.file` or mapped text column).

## Configuring a search tool

1. **search_field** — primary text embedded for similarity (one field per tool).
2. **return_fields** — columns returned to the agent (ids, titles, URLs). Prefix raw keys with `raw.`.
3. Link one or more ingestion groups; only **approved** entries participate.

## Common mistakes

- Referencing `raw.body` when mapping uses `description` — use `raw.description`.
- Embedding before entries exist or before approval — status stays errored or returns empty.
- Ingesting or syncing new rows and skipping **Initiate Embedding** — search and LLM tools that use search stay short until you embed again (or enable Auto-embed).
- Same return field name across groups with different semantics — split tools or align slugs.

## Validation

Settings → Tools validates search and return fields against declared column mappings and known output keys. Fix validation errors before saving; they prevent broken runtime tool calls.