← → 翻页 · B 静态 · ESC 索引
Agents Platform · Field Note 01
SS · 26.07.15 · 01 / 22
RD INTERNAL BRIEFING

云端 harness
平台

面向研发部：Manage 模块怎么拼 Agent，以及一次任务从 Web submit 到 Deep Agent runtime 的完整链路。
~30 MIN · 22 PAGES · IKB
→ arrow keys
HOOK · CONFIG VS RUNTIME
02 / 22
STATEMENT

配置时决定能力，
运行时决定效果。

Manage 像积木一样拼装 Agent profile；Runtime 按 profile 装配成真正的 Agent。

PLATFORM · THREE SURFACES
03 / 22
ARCHITECTURE

三个组件

同一 API 前缀下，Manage、Web UI、Runtime 各管一层。

01
Manage · 5174
配置 Provider / LLM / Skills / Tools / MCP / Agent / Billing
/manage/*
02
Web UI · 5175
选 Agent、建 Thread、submit run、消费 SSE
LANGGRAPH SDK
03
Runtime · 30030
build_agent → create_deep_agent，按 agent_id 装配
GRAPH · AGENTS-PLATFORM
ACT I · MANAGE CONSOLE
04 / 22
CHAPTER INDEX
01
模块关系总图
02
能力从哪来
03
建议顺序 · 装配演示
DEPENDENCY GRAPH
05 / 22
CORE CHAIN · TOPOLOGY

Provider → LLM → Agent

先看依赖：模型通路打通后，Agent 成为装配中心；右侧四类能力都挂在 Agent 上。横切能力（Billing / API Key / 2FA / Dashboard）见后页。

LAYER A
Provider

厂商通道 · API Key / 启停

LAYER B
LLM

挂到 Provider · model / profile

LAYER C · HUB
Agent

必选 llm_id · 再挂右侧资源

Skills

挂到 Agent

Tools

挂到 Agent

MCP

挂到 Agent

Sub-Agent

Agent → Agent

SOURCE · HOW IT GETS IN
06 / 22
SIX CELLS · ORIGIN

能力从哪来

01
Provider
内置硬编码列表 · 只能配 Key / 启停 · 不可新建厂商
02
LLM
在已有 Provider 下新建模型条目 · model / profile
03
Skills
ZIP 上传或 Manual · 可手建 · 运行时挂 /skills/
04
Tools
启动扫描本地代码注册 · 不可手建/删除 · 只能启停看 schema
05
MCP
填 URL / 超时 / Headers · 可配置远端 Server
06
Sub-Agent
勾选已有 Agent · 复用其配置 · 不新开一套装配
RECOMMENDED ORDER
07 / 22
SETUP PIPELINE

建议配置顺序

先打通模型通路，再准备能力资源，最后封 Agent；Billing 与平台 API Key 可选后置（勿与 Provider 厂商 Key 混淆）。

01
Provider
启用厂商
02
LLM
建模型
03
能力
S / T / M
04
Agent
完成装配
05
后置
Billing · Plat Key
AGENT · CALL_LIMIT
08 / 22
COST GUARD

调用上限为什么重要

模型降智或工具死循环时，会反复烧 token。CALL_LIMIT 是费用保险丝。

!不设限
费用易爆炸

卡住后模型与工具可能反复调用，账单在无人察觉时爬升。

  • 降智胡调用
  • 工具死循环
  • 长时间无人中断
✓建议
配上 CALL_LIMIT

Agent → 运行配置 → CALL_LIMIT：分别给 model / tools 设 thread_limit 与 run_limit。

  • run：单次请求上限
  • thread：整段对话累计
  • 留空 = 不限制（生产慎用）
AGENT · PERFORMANCE
09 / 22
DURABILITY

何时用 exit

PERFORMANCE · durability 控制 checkpoint 写入时机。可恢复性换写入次数。

A默认
async / sync

运行过程中也会写 checkpoint，中途失败还能恢复现场。

  • 需要续跑 / 排障
  • 长任务、贵资源
  • 写入更频繁
Bexit
少写 checkpoint

仅在 run 结束时写入。后台调用失败通常不恢复的场景，可开 exit 降低写入压力。

  • 失败可重提、不必续跑
  • 短请求、高 QPS
  • 中途崩溃不可恢复
Agent 运行配置 BASE：LLM + Skills + Tools
EVIDENCE · AGENT BASE
10 / 22
Agent
装配现场
编辑「投标风险检测」→ 运行配置 BASE：选 LLM、写 system prompt、挂 Skills / Tools / MCP / Sub-Agent。
LLM
必选

每个 Agent 一个 llm_id

Mount
4 类

Skill / Tool / MCP / Sub

Tabs
BASE+

限流 / Thinking / Workspace

CROSS-CUTTING
11 / 22
FOUR CARDS

横切四件事

— 01 / DASH
Dashboard

库存、近 7 日用量、活跃 Run，可中断执行

— 02 / BILL
Billing

积分方案覆盖式绑 Agent，看扣费审计

— 03 / KEY
API Key

后端接入 Platform API Key，与用户 Token 并列

— 04 / 2FA
安全 / 2FA

TOTP step-up，保护查看明文密钥

ACT II · ONE RUN
12 / 22
CHAPTER

一次任务
怎么跑

从 ChatInput 到 SSE，主路径在 LangGraph threads / runs，不在 /web/*。

13 / 22
THESIS
CORE

Chat 走
runs/stream

LANGGRAPH HTTP API
NOT THE INFERENCE PATH

/web/agents、workspace、billing 列表是旁路业务 API。

发消息：useChatStream → POST …/threads/{id}/runs/stream。

调试先盯 agent_id + runs/stream，再去翻 /web/*。

Web UI 聊天：消息、Send、Skills 入口
EVIDENCE · WEB SUBMIT
14 / 22
用户点
Send
useChatStream.sendMessage → LangGraph SDK stream.submit；header 带 Auth / ApiKey。
Mode
values+

messages-tuple / custom

Config
agent_id

configurable 注入

Subgraph
true

可观察 sub-agent

END-TO-END
15 / 22
HAPPY PATH · 5 STEPS

Submit → Runtime

01
Submit
ChatInput
02
Thread+SSE
create · runs/stream
03
Auth
owner
04
Build
build_agent
05
Render
MessageList
MAIN PATH VS SIDE PATH
16 / 22
DUO COMPARE

两条 API 轴

APRIMARY
LangGraph

threads / runs / stream 是对话执行主路径

  • POST /threads
  • POST /threads/{id}/runs/stream
  • auth.authenticate + owner_only
  • metadata 写 owner / agent_id
BSIDE
/web/*

业务旁路：列表、workspace、计费查询

  • /web/agents 元数据
  • workspace 文件上传
  • billing 余额事件配套
  • require_thread_access
BUILD_AGENT
17 / 22
RUNTIME ASSEMBLY

三步造 Agent

创建 Deep Agent 实例

01
load_runtime_config
DB / cache → RuntimeAgentConfig（按 agent_id）
CONFIG
02
Backend + Tools
workspace + /skills/ · 本地 Tool · MCP tools · sub-agents
COMPOSITE
03
create_deep_agent
model / prompt / middleware / response_format
DEEP AGENT
WHAT GETS INJECTED
18 / 22
BRIEF · SIX

注入清单

Model
build_chat_model
Tools
registry paths
MCP
load_mcp_tools
Skills
/skills/ mount
Sub-agents
+ general-purpose
Middleware
billing · title · …
STREAM LOOP
19 / 22
SSE MODES
01
values

完整 state 快照

02
messages-tuple

token / 消息增量

03
updates · custom

节点更新 · 计费 / 标题事件

04
MessageList

useStream 渲染闭环

SSE
HOW TO · THINKING
20 / 22
USAGE

深度思考怎么用

模型需支持推理。若希望用户在聊天里自己开关，后台优先权选「前端」。

01
后台配置
Agent → 运行配置 → THINKING。设默认档位：关 / 低 / 中 / 高 / 最高。
选好默认，也能设前端优先
02
前台开关
聊天输入区出现「深度思考」开关与档位；仅「前端优先」时可见，用户可改。
后端优先时前台不出现
03
你会得到
回答通常更深入；代价是更慢、更费 token。
按需打开即可
HOW TO · STRUCTURED OUTPUT
21 / 22
USAGE

结构化输出怎么用

Schema 只在后台配置。前台只有一个开关，没有选 Schema。两边都开才生效。

01
后台写 Schema
Agent → 结构化输出：开启，并填写 / 生成 JSON Schema（Schema 不在前台选）。
Schema 只配一次
02
前台开开关
聊天区仅显示「结构化输出」开关；默认关，需要结构化结果时再打开。
无 Schema 下拉选择
03
你会得到
按后台 Schema 返回结构化结果，方便下游系统直接消费。
后台启用 + 前台打开
Agents Platform · Field Note
22 / 22
Q & A
Thanks.
Agents Platform · 研发部内部讲解 · 欢迎提问