Skip to main content
POST
Post Intent Find

Headers

X-Site-ID
string
required
authorization
string | null

Body

application/json

Agent → Stella: natural-language product search.

query is a free-form natural-language request like "warm hat for hiking under NPR 2000". Phase 6-C1 reuses the keyword + trigram engine from Phase 3-B; semantic search lands later.

query
string
required
Required string length: 1 - 512
max_results
integer
default:5

Maximum candidates to return. Default 5 keeps the LLM context window small; max 20 because more than that is rarely useful for an intent flow.

Required range: 1 <= x <= 20

Response

Successful Response

Response shape for POST /api/agent/intent/find.

query
string
required
candidates
AgentIntentCandidate · object[]
required
reasoning
string
required

Overall search-strategy summary (e.g. 'Matched against tsvector with cover-density rank; 5 candidates above noise floor'). Lets the agent surface trust signals to the customer without parsing per-candidate match_reasons.