ResearchAnswerPart
Represents part of a research answer with source information.
Properties
| Property | Required | Type | Description |
|---|---|---|---|
| title | False | String | A title representing the generated text content. |
| text | True | String | The generated text of this answer part. |
| sourceChunkIds | True | List[String] | IDs of source chunks used for generating this text. These IDs refer to Chunk objects in ResearchResponse.chunks. |
| type | True | String | The type of this answer part. See the available types below. |
Answer Part Types
The type field indicates the kind of content the answer part represents. The currently supported values are:
| Type | Description |
|---|---|
bullet | A regular answer part containing a piece of the research answer, typically a bullet point with source citations. This is the default and most common type. |
warning | A user-facing warning message indicating that the user's query may not be fully supported by the system. When present, this is typically the first part in the answer. The system still attempts to provide a best-effort response in subsequent bullet parts. |
error | An error message, e.g., when the system encounters an issue during processing. |
When the type is warning, the warning is returned as the first answer part, followed by regular bullet parts with a best-effort answer.
The warning is a plain-text, user-facing message intended to be displayed directly to the end user.
It does not carry a structured error code or category identifier — clients should simply present the warning text as-is and do not need to handle it programmatically beyond displaying it.