docs(portai): 新增 AI Agent 对话 API 文档#1129
Open
lvwxx wants to merge 3 commits into
Open
Conversation
lvwxx
commented
Jul 3, 2026
lvwxx
commented
Member
- 新增 conversation.md 描述发起对话接口 POST /v1/babbage/agents/:id/conversations，含阻塞式与 SSE 流式两种响应模式及请求示例
- 新增 continue.md 描述继续对话接口，覆盖 answers_by_tool_call 结构、多次中断续跑及归属校验规则
- conversation.md 提供 conversation_response schema，含 interrupt 中断结构（node_id、tool_call_id、questions）与 error 字段说明
- 新增 portai 与 chat 目录的 category.json，配置 sidebar 位置（2.7）、cpu 图标与分组标签
- en / zh-CN / zh-HK 三语言目录同步创建，内容与结构保持一致
added 3 commits
July 3, 2026 12:43
- 新增 conversation.md 描述发起对话接口 POST /v1/babbage/agents/:id/conversations，含阻塞式与 SSE 流式两种响应模式及请求示例 - 新增 continue.md 描述继续对话接口，覆盖 answers_by_tool_call 结构、多次中断续跑及归属校验规则 - conversation.md 提供 conversation_response schema，含 interrupt 中断结构（node_id、tool_call_id、questions）与 error 字段说明 - 新增 portai 与 chat 目录的 _category_.json，配置 sidebar 位置（2.7）、cpu 图标与分组标签 - en / zh-CN / zh-HK 三语言目录同步创建，内容与结构保持一致
- 新增 workspace/workspaces.md，文档化 GET /v1/ai/workspaces 接口，含请求示例与 workspaces_response schema - 新增 workspace/agents.md，文档化 GET /v1/ai/workspaces/:id/agents 接口，说明返回的 uid 用于发起对话且仅 is_published 的 Agent 可用 - 新增 workspace/_category_.json（position: 0），将 Workspace 分组置于 portai 侧边栏最前 - chat/conversation.md 与 chat/continue.md 的接口路径及 cURL 示例由 /v1/babbage/agents 改为 /v1/ai/agents，全仓已无 babbage 残留 - en / zh-CN / zh-HK 三语言目录同步新增与修改，内容保持一致
- docs/{en,zh-CN,zh-HK}/docs/portai 整体重命名为 docs/{lang}/docs/ai，URL 由 /docs/portai/* 变为 /docs/ai/*
- 同步更新 conversation.md、continue.md、agents.md、workspaces.md 中全部内链引用（含 #schemaconversation_response 锚点）
- conversation.md 新增 tip 提示块，说明可从 Longbridge 网页端对话页 URL 直接获取 Agent UID
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.