Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
/v1/sessions — 创建长期会话、追加事件、回放历史、中断运行
POST /v1/agents/run 每次自己带 session_id，会话接口让你显式地创建、查询、回放和中断它。
POST https://api.profy.cn/v1/sessions
curl -X POST https://api.profy.cn/v1/sessions \
-H "Authorization: Bearer sk-pro-your-key" \
-H "Content-Type: application/json" \
-d '{"agent": "my-expert", "environment_id": "env_abc"}'
{
"code": 0,
"message": "ok",
"data": { "id": "ses_abc123", "agent": "my-expert", "environment_id": "env_abc", "status": "idle" }
}
POST https://api.profy.cn/v1/sessions/{session_id}/events
user.message，其它值会返回 400。curl -N -X POST https://api.profy.cn/v1/sessions/ses_abc123/events \
-H "Authorization: Bearer sk-pro-your-key" \
-H "Content-Type: application/json" \
-H "Accept: text/event-stream" \
-d '{"content": "帮我看看这份报关单"}'
GET https://api.profy.cn/v1/sessions/{session_id}/events?after={event_id}&limit=100
{
"code": 0,
"data": {
"events": [
{ "id": "msg_1", "type": "user.message", "role": "user", "content": "你好", "metadata": {}, "created_at": "..." },
{ "id": "msg_2", "type": "assistant.message", "role": "assistant", "content": "你好，我是…", "metadata": {}, "created_at": "..." }
]
}
}
after 传一个不存在的 ID 时会从头回放，而不是返回空——空结果和”已追上”无法区分。limit 最大 200。
POST https://api.profy.cn/v1/sessions/{session_id}/interrupt
| 方法 | 路径 | 说明 |
|---|---|---|
GET | /v1/sessions?agent=&limit= | 列出你的会话，最多 100 条 |
GET | /v1/sessions/{id} | 会话详情，含绑定的 agent 与 environment |
DELETE | /v1/sessions/{id} | 删除会话及其消息 |
| HTTP 状态码 | 说明 |
|---|---|
400 | 缺少 agent / content，或 type 不受支持 |
401 | 认证失败 |
404 | 会话不存在、不属于你，或 environment_id 无效 |