Create session
Creates a session. A session refers to the continuous interaction between the user and Powerdrill within a conversation. Your team can have up to 150 sessions simultaneously. If the limit is reached, you can remove unnecessary sessions to make space for new ones.
Authorizations
Headers
The external trace ID. The length ranges from 0 to 128 characters.
Body
The session name, which can be up to 128 characters in length. If it exceeds this limit, it will be truncated.
Your user ID.
How to obtain your user ID: Sign in to Powerdrill Enterprise, click Users in the top navigation bar, and find your user ID in the list of users.
The ID of the agent. You don't need to specify it or set it to DATA_ANALYSIS_AGENT.
Job mode. Possible values are:
AUTO
: Powerdrill automatically detects your intent and selects the appropriate job mode from data analysis and information retrieval.DATA_ANALYTICS
: Powerdrill focuses specifically on data analysis.
AUTO
, DATA_ANALYTICS
The language in which the output is generated. Possible values are:
AUTO
: adaptive recognitionEN
: EnglishES
: SpanishAR
: ArabicPT
: PortugueseID
: IndonesianJA
: JapaneseRU
: RussianHI
: HindiFR
: FrenchDE
: GermanVI
: VietnameseTR
: TurkishPL
: PolishIT
: ItalianKO
: KoreanZH-CN
: Simplified ChineseZH-TW
: Traditional Chinese
AUTO
, EN
, ES
, AR
, PT
, ID
, JA
, RU
, HI
, FR
, DE
, VI
, TR
, PL
, IT
, KO
, ZH-CN
, ZH-TW
The maximum number of messages retained per session, with a value range of 0 to 10. The default is 10.
You can set it to 0 if you don't want your answer is to contain any context of job history.
Response
Status code. 0 indicates that the operation is successful. Otherwise, the operation fails. Possible error codes include:
- 100: Bad request.
- 201: Request frequency limit.
- 9999: Internal error.
- 100001: Invalid operation.
The returned data object.