Skip to main content

ResearchRequest

Request object for the research feature.

Properties

PropertyRequiredTypeDescription
queryTrueStringInstructions for the research agent.
modeFalseStringThe research mode to use, e.g., "lightweight" or "deep".
articleFiltersFalseMapFilters on the articles' metadata fields that restrict the search scope. See this guide for details.
paramsFalseResearchParamsAdditional parameters for the research agent. All parameters are optional.
previousInteractionIdFalseStringID of the previous interaction in the conversation; value of the interactionId field from an earlier API response.
historyFalseList[HistoryInteraction]History of a previous conversation with the agent. Used to reconstruct context when the original server-side conversation has expired.
returnHistoryFalseBooleanWhether to return the conversation history in the API response.
returnArticlesFalseBooleanWhether to return Article objects in the API response.
returnDuplicatesFalseBooleanWhether to return ArticleDuplicate and ChunkDuplicate objects in the API response, as duplicates of the source articles and text chunks.
returnArticleFieldsFalseList[String]Fields to include in the Article objects returned in the articles field, if returnArticles is set to true.
returnParagraphFieldsFalseList[String]Fields to include in the Paragraph objects returned in the paragraphs field.