Files
data-ge/doc/会话api.md
2025-12-08 23:15:04 +08:00

1.4 KiB

创建会话

curl -X POST "/api/v1/chat/sessions"
-H "Content-Type: application/json"
-d "{"user_id": $CHAT_USER_ID}"

获取会话

curl "/api/v1/chat/sessions/{session_id}"

按用户列出会话

curl "/api/v1/chat/sessions?user_id=$CHAT_USER_ID"

更新会话状态

curl -X POST "/api/v1/chat/sessions/{session_id}/update"
-H "Content-Type: application/json"
-d '{"status":"PAUSED"}'

关闭会话

curl -X POST "/api/v1/chat/sessions/{session_id}/close"

创建对话轮次

curl -X POST "/api/v1/chat/sessions/{session_id}/turns"
-H "Content-Type: application/json"
-d '{ "user_id": '"$CHAT_USER_ID"', "user_query": "展示昨天订单GMV", "intent": "METRIC_QUERY", "ast_json": {"select":["gmv"],"where":{"dt":"yesterday"}}, "main_metric_ids": [1234], "created_metric_ids": [] }'

获取单条对话轮次

curl "/api/v1/chat/turns/{turn_id}"

列出会话下的轮次

curl "/api/v1/chat/sessions/{session_id}/turns"

写入检索结果

curl -X POST "/api/v1/chat/turns/{turn_id}/retrievals"
-H "Content-Type: application/json"
-d '{ "retrievals": [ {"item_type":"METRIC","item_id":"metric_foo","used_in_sql":true,"rank_no":1}, {"item_type":"SNIPPET","item_id":"snpt_bar","similarity_score":0.77,"rank_no":2} ] }'

列出轮次的检索结果

curl "/api/v1/chat/turns/{turn_id}/retrievals"