HTTP SSE is a unidirectional channel. After the client initiates an HTTP request, the server continuously pushes streaming data to the client, and bidirectional interaction is not supported at this stage.
Session ID, used to identify a session (provided by an external system; it is recommended to pass in different ConversationId for different user end sessions, otherwise message records of different users under the same application will be intermingled).
Parameter length: 32-64 characters.
Validation rule: ^[a-zA-Z0-9_-]{32,64}$, which can generally be generated using a uuid.
Streaming response frequency control: Controls the frequency of application response packets. This value indicates how many characters the application accumulates before returning a packet to the caller. A smaller value results in more frequent packet returns (smoother experience but higher traffic overhead). When no value is provided or the value is 0, it defaults to the system configuration.
Default value: 5
Recommended maximum value: 100
Attention:
This setting does not accelerate the output time of large models either; it only changes the frequency of returning response packets to the caller. Therefore, if set too high, there may be no response packets for an extended period.
SystemRole
String
No
Role instruction (prompt). When it is left blank, the default setting in the application configuration is used; when it is filled, the current value is used.
Maximum value limit: Varies for different models. See the RoleLenLimit of the ListModel API.
Incremental
Boolean
No
Controls whether the text content of the response is returned as a text.delta event or a text.replace event. Default: false.
Attention:
When Incremental is true, text content is not entirely returned as text incremental events. The ADP backend returns a text replacement event when it detects a need to modify content that has already been returned.
SearchNetwork
String
No
Whether to enable online search. Valid values:
Empty string: Follow the application configuration.
enable: Enable online search
disable: Disable online search
Attention:
The value field is meaningless when online search is not enabled in application configuration.
ModelName
String
No
Support for passing a specified model during the conversation. Different model names can be passed under the same session_id to maintain contextual continuity.
Attention:
Ensure sufficient PU resources are available in your account to avoid errors during usage.
Stream
String
No
Whether to enable streaming transmission. Valid values:
Empty string: Follow the application configuration.
enable: Streaming
disable: Non-streaming
WorkflowStatus
String
No
Whether to enable workflow. Valid values:
Empty string: Follow the application configuration (The page has no entry point for configuring the workflow switch, and it is enabled by default).
enable: workflow
disable: workflow
EnableMultiIntent
Boolean
No
Whether to enable multi-intent.
GenerateAgain
Boolean
No
Whether to regenerate the request.
1.2 How to Obtain AppKey
In the Application Management page, locate your application in the running state (must be published first), click Call, and a "Call Information" window will pop up.
In the Call Information window, you can see the AppKey. Click Copy to copy it.
1.3 curl invocation example
Text Q&A:
curl --location --request POST 'https://wss.lke.tencentcloud.com/adp/v2/chat'\\
data: {"Type":"response.processing","Response":{"Role":"assistant","RecordId":"I5m_20251223_020145_960_5mpLgT4a","RelatedRecordId":"VJx_20251223_020145_889_xiiAQ0s2","ConversationId":"d4bca75f-e713-42c4-ad37-67b7d6621f10","Status":"processing","StatusDesc":"large model direct reply","ExtraInfo":{"RequestId":"ExmjIGL6Oy-7035160285","TraceId":"b3dcff6179e3a289b8b29dfb3d302bba / I5m_20251223_020145_960_5mpLgT4a","Elapsed":"2089","StartTime":"1766426505888","IsFromSelf":false,"IsLlmGenerated":false,"CanRating":false,"CanFeedback":false,"ReplyMethod":0,"FromName":"","FromAvatar":"","HasRead":false}}}
event: response.processing
data: {"Type":"response.processing","Response":{"Role":"assistant","RecordId":"I5m_20251223_020145_960_5mpLgT4a","RelatedRecordId":"VJx_20251223_020145_889_xiiAQ0s2","ConversationId":"d4bca75f-e713-42c4-ad37-67b7d6621f10","Status":"processing","StatusDesc":"large model direct reply","ExtraInfo":{"RequestId":"ExmjIGL6Oy-7035160285","TraceId":"b3dcff6179e3a289b8b29dfb3d302bba / I5m_20251223_020145_960_5mpLgT4a","Elapsed":"2373","StartTime":"1766426505888","IsFromSelf":false,"IsLlmGenerated":false,"CanRating":false,"CanFeedback":false,"ReplyMethod":1,"FromName":"","FromAvatar":"","HasRead":false}}}
data: {"Type":"text.delta","MessageId":"rpl_I5m_20251223_020145_960_5mpLgT4a","Text":"Hello! How can I help you?"}
event: response.processing
data: {"Type":"response.processing","Response":{"Role":"assistant","RecordId":"I5m_20251223_020145_960_5mpLgT4a","RelatedRecordId":"VJx_20251223_020145_889_xiiAQ0s2","ConversationId":"d4bca75f-e713-42c4-ad37-67b7d6621f10","Status":"processing","StatusDesc":"large model direct reply","ExtraInfo":{"RequestId":"ExmjIGL6Oy-7035160285","TraceId":"b3dcff6179e3a289b8b29dfb3d302bba / I5m_20251223_020145_960_5mpLgT4a","Elapsed":"2488","StartTime":"1766426505888","IsFromSelf":false,"IsLlmGenerated":false,"CanRating":false,"CanFeedback":false,"ReplyMethod":1,"FromName":"","FromAvatar":"","HasRead":false}}}
data: {"Type":"message.done","MessageId":"rpl_I5m_20251223_020145_960_5mpLgT4a","Message":{"Type":"reply","MessageId":"rpl_I5m_20251223_020145_960_5mpLgT4a","Name":"reply","Title":"","Icon":"","Status":"success","StatusDesc":"reply completed","Contents":[{"Type":"text","Text":"Hello! How can I help you?"}],"ExtraInfo":{"Elapsed":"201","StartTime":"1766426508261"}}}
event: response.completed
data: {"Type":"response.completed","Response":{"Role":"assistant","RecordId":"I5m_20251223_020145_960_5mpLgT4a","RelatedRecordId":"VJx_20251223_020145_889_xiiAQ0s2","ConversationId":"d4bca75f-e713-42c4-ad37-67b7d6621f10","Status":"success","StatusDesc":"large model direct reply","Messages":[{"Type":"reply","MessageId":"rpl_I5m_20251223_020145_960_5mpLgT4a","Name":"reply","Title":"","Icon":"","Status":"success","StatusDesc":"reply completed","Contents":[{"Type":"text","Text":"Hello! How can I help you?"}],"ExtraInfo":{"Elapsed":"201","StartTime":"1766426508261"}}],"Procedures":[{"Name":"large_language_model","Title":"large model direct reply","Status":"success","IntentCate":"self_awareness","ResourceStatus":0,"Type":"agent","Agent":{"ModelName":"","Input":"","Output":"","Content":"Hello","System":"You are the Tencent Cloud Intelligent Agent development platform, an intelligent platform skilled in document reading and knowledge Q&A. Possessing vast industry knowledge, it has been fine-tuned and optimized over 10 fundamental capabilities for vertical industries, covering document reading comprehension, semantic understanding, security compliance, etc., which can help users solve industry problems and improve work efficiency. Please note that the current time is 2025-12-23 02:01:47","RewriteQuery":""}}],"StatInfo":{"InputTokens":0,"OutputTokens":0,"TotalTokens":602,"TotalCost":"2574"},"ExtraInfo":{"RequestId":"ExmjIGL6Oy-7035160285","TraceId":"b3dcff6179e3a289b8b29dfb3d302bba / I5m_20251223_020145_960_5mpLgT4a","Elapsed":"2676","StartTime":"1766426505888","IsFromSelf":false,"IsLlmGenerated":true,"CanRating":true,"CanFeedback":false,"ReplyMethod":1,"FromName":"rodneyxiong_standard","FromAvatar":"https://cdn.xiaowei.qq.com/static/adp/app-default-avatar.png","HasRead":false}}}
event: done
data: [DONE]
1.4 Postman call example
2. HTTP SSE API response
2.1 Request Confirmation Event
Event name: request_ack
Event direction: backend > frontend
Attention:
If a sent request event is blocked due to security review or exceeds the concurrency limit, the backend will not return a request acknowledgment event but rather an error event.
"Text": "The current task is to generate a small cat picture for the user. This does not directly involve image creation within my professional capabilities, but I have the ability to invoke the text-to-image tool to fulfill this requirement. The task is clear and should not ask the user for more information; directly execute the text-to-image process."
}
],
"ExtraInfo": {
"Elapsed": "2679",
"StartTime": "1766242718724",
"AgentName": "TT Expert Intelligent Agent - Mo Jiao - prod"
"Text": "The current task is to generate a small cat picture for the user. This does not directly involve image creation within my professional capabilities, but I have the ability to invoke the text-to-image tool to fulfill this requirement. The task is clear and should not ask the user for more information; directly execute the text-to-image process."
}
],
"ExtraInfo": {
"Elapsed": "2679",
"StartTime": "1766242718724",
"AgentName": "TT Expert Intelligent Agent - Mo Jiao - prod"
"Text": "The current task is to generate a small cat picture for the user. This does not directly involve Image Creation within my professional capabilities, but I can invoke the text-to-image tool to fulfill this requirement. The task is clear and should not require additional user information; proceed directly with text-to-image execution."
}
],
"ExtraInfo": {
"Elapsed": "2679",
"StartTime": "1766242718724",
"AgentName": "TT Expert Intelligent Agent - Mo Jiao - prod"
"Text": "I have used the text-to-image tool to generate a small cat picture and obtained the returned link. Next, I should directly display the image to the user, conclude with natural language, and then end the task."
}
],
"ExtraInfo": {
"Elapsed": "2190",
"StartTime": "1766242727002",
"AgentName": "TT Expert Intelligent Agent - Mo Jiao - prod"
"Text": "Okay, together we conceived a warm and simple scene, presenting a cute little cat with soft colors, in a leisurely pose, embodying the charm of nature and life. Please see—\\n\\n\\n\\nIn design, we often say that 'objects carry meaning, interest, and morality.' In fact, small animals can also become gentle companions and sources of inspiration in life. I hope this image brings you a moment of relaxation and joy."
}
],
"ExtraInfo": {
"Elapsed": "1549",
"StartTime": "1766242729698"
}
}
],
"Procedures": [
{
"Name": "thinking_model",
"Title": "Invoke reasoning model"
"Status": "success",
"IntentCate": "",
"ResourceStatus": 0,
"StatInfos": [
{
"InputTokens": 2884,
"OutputTokens": 86,
"TotalTokens": 2970,
"ModelName": "100021406304-OpenAI/ouFPaKKL"
}
],
"Type": "agent",
"Agent": {
"ModelName": "100021406304-OpenAI/ouFPaKKL",
"Input": "",
"Output": "[{\\"id\\":\\"call_af6a8234f2180102\\",\\"type\\":\\"function\\",\\"function\\":{\\"name\\":\\"Text-to-Image\\",\\"arguments\\":\\"{\\\\\\"prompt\\\\\\":\\\\\\"a cute little cat, with soft fur, in a leisurely pose, in a warm and simple scene, embodying the charm of nature and life\\\\\\"}\\"},\\"index\\":0}]\\n",
"Content": "",
"RewriteQuery": ""
}
},
{
"Name": "tool_call",
"Title": "Invoke Text-to-Image"
"Status": "success",
"IntentCate": "",
"ResourceStatus": 0,
"Type": "agent",
"Agent": {
"ModelName": "",
"Input": "{\\"name\\":\\"Text-to-Image\\",\\"arguments\\":\\"{\\\\\\"prompt\\\\\\":\\\\\\"a cute little cat, with soft fur, in a leisurely pose, in a warm and simple scene, embodying the charm of nature and life\\\\\\"}\\"}\\n",
"Output": "[{\\"id\\":\\"call_fa9caa370c1d7aad\\",\\"type\\":\\"function\\",\\"function\\":{\\"name\\":\\"task_done\\",\\"arguments\\":\\"{\\\\\\"success\\\\\\": true, \\\\\\"final_response\\\\\\": \\\\\\"Okay, together we conceived a warm and simple scene, presenting a cute little cat with soft colors, in a leisurely pose, embodying the charm of nature and life. Please see—\\\\\\\\n\\\\\\\\n\\\\\\\\n\\\\\\\\nIn design, we often say that 'objects carry meaning, interest, and morality.' In fact, small animals can also become gentle companions and sources of inspiration in life. I hope this image brings you a moment of relaxation and joy.\\\\\\"}\\"},\\"index\\":0}]\\n",
"Text": "The current task is to generate a small cat picture for the user. This does not directly involve Image Creation within my professional capabilities, but I can invoke the text-to-image tool to fulfill this requirement. The task is clear and should not require additional user information; proceed directly with text-to-image execution."
}
],
"ExtraInfo": {
"Elapsed": "2679",
"StartTime": "1766242718724",
"AgentName": "TT Expert Intelligent Agent - Mo Jiao - prod"
"Text": "I have used the text-to-image tool to generate a small cat picture and obtained the returned link. Next, I should directly display the image to the user, conclude with natural language, and then end the task."
}
],
"ExtraInfo": {
"Elapsed": "2190",
"StartTime": "1766242727002",
"AgentName": "TT Expert Intelligent Agent - Mo Jiao - prod"
"Text": "Okay, together we conceived a warm and simple scene, presenting a cute little cat with soft colors, in a leisurely pose, embodying the charm of nature and life. Please see—\\n\\n\\n\\nIn design, we often say that 'objects carry meaning, interest, and morality.' In fact, small animals can also become gentle companions and sources of inspiration in life. I hope this image brings you a moment of relaxation and joy."
}
],
"ExtraInfo": {
"Elapsed": "1549",
"StartTime": "1766242729698"
}
}
],
"Procedures": [
{
"Name": "thinking_model",
"Title": "Invoke reasoning model"
"Status": "success",
"IntentCate": "",
"ResourceStatus": 0,
"StatInfos": [
{
"InputTokens": 2884,
"OutputTokens": 86,
"TotalTokens": 2970,
"ModelName": "100021406304-OpenAI/ouFPaKKL"
}
],
"Type": "agent",
"Agent": {
"ModelName": "100021406304-OpenAI/ouFPaKKL",
"Input": "",
"Output": "[{\\"id\\":\\"call_af6a8234f2180102\\",\\"type\\":\\"function\\",\\"function\\":{\\"name\\":\\"Text-to-Image\\",\\"arguments\\":\\"{\\\\\\"prompt\\\\\\":\\\\\\"a cute little cat, with soft fur, in a leisurely pose, in a warm and simple scene, embodying the charm of nature and life\\\\\\"}\\"},\\"index\\":0}]\\n",
"Content": "",
"RewriteQuery": ""
}
},
{
"Name": "tool_call",
"Title": "Invoke Text-to-Image"
"Status": "success",
"IntentCate": "",
"ResourceStatus": 0,
"Type": "agent",
"Agent": {
"ModelName": "",
"Input": "{\\"name\\":\\"Text-to-Image\\",\\"arguments\\":\\"{\\\\\\"prompt\\\\\\":\\\\\\"a cute little cat, with soft fur, in a leisurely pose, in a warm and simple scene, embodying the charm of nature and life\\\\\\"}\\"}\\n",
"Output": "[{\\"id\\":\\"call_fa9caa370c1d7aad\\",\\"type\\":\\"function\\",\\"function\\":{\\"name\\":\\"task_done\\",\\"arguments\\":\\"{\\\\\\"success\\\\\\": true, \\\\\\"final_response\\\\\\": \\\\\\"Okay, together we conceived a warm and simple scene, presenting a cute little cat with soft colors, in a leisurely pose, embodying the charm of nature and life. Please see—\\\\\\\\n\\\\\\\\n\\\\\\\\n\\\\\\\\nIn design, we often say that 'objects carry meaning, interest, and morality.' In fact, small animals can also become gentle companions and sources of inspiration in life. I hope this image brings you a moment of relaxation and joy.\\\\\\"}\\"},\\"index\\":0}]\\n",
For other programming languages, Demo is currently not available. You can refer to the documentation and existing Demos to implement on your own.
The purpose of the Demo is for rapid validation, using the HTTP SSE communication method. Users may choose the WebSocket communication method based on actual business requirements.
