Request parameters

This page explains two things: who the request is for, and where you want the result to appear.

User Context

userContext tells the system who this request is about and who initiated the session.

{
  "userContext": {
    "userId": "user-123",
    "sessionId": "session-abc"
  }
}

Most common fields:

userId: A stable user identifier that helps with frequency control and user-level policy
sessionId: The current session identifier that ties a request path together

slots tell the system what kind of result you want and where you plan to place it.

{
  "slots": [
    {
      "slotId": "main-chat",
      "format": "action_card",
      "count": 3
    }
  ]
}

Most common fields:

slotId: The unique identifier for a placement or result position
format: The expected result format, such as action_card, suffix, or entity_link
count: The number of results you expect back