Express Agent
This endpoint answers the user’s query with an LLM. Optionally, you can ground the answer using web results (max 1 web search).
Use it for answering simple questions that require a low latency response.
The data returns as SSE (Server-Side Events) with the `text/event-stream` content type in the response header.
<Info> This call streams data as the agent responds.</Info>
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
This endpoint expects an object.
agent
Setting this value to "express" is mandatory to use the express agent.
Allowed values:
input
The question you'd like to ask the agent
stream
Must be set to true when you want to stream the express agent response as its being generated, and false when you want the response to return after the agent has finished.
tools
You can optionally ground the express agent response using results fetched from the web (max 1 web search)
Response
response.created
SSE event signifying the response stream has been created
OR
response.starting
SSE event signifying the response is starting
OR
response.output_item.added
SSE event signifying an output item has been added
OR
response.output_content.full
OR
response.output_item.done
OR
response.output_text.delta
OR
response.done