@roll-agent/browser-use-agent 0.13.0 → 0.15.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/SKILL.md +114 -0
- package/dist/auto-window-layout.d.ts +21 -0
- package/dist/browser-instance-pool.d.ts +39 -0
- package/dist/diagnostics/effective-env.d.ts +1 -1
- package/dist/index.js +1 -1
- package/dist/pages/zhipin/semantic-refs.d.ts +1 -0
- package/dist/runtime-config.d.ts +334 -0
- package/dist/runtime-holder.d.ts +10 -1
- package/dist/tools/browser-instance-input.d.ts +8 -0
- package/dist/tools/browser-instance-platform.d.ts +3 -0
- package/dist/tools/browser-ref-schemas.d.ts +12 -12
- package/dist/tools/browser-status.d.ts +23 -0
- package/dist/tools/browser-stop.d.ts +80 -0
- package/dist/tools/click-ref.d.ts +2 -2
- package/dist/tools/type-ref.d.ts +2 -2
- package/dist/tools/zhipin-get-username.d.ts +1 -1
- package/package.json +2 -2
- package/references/env.yaml +7 -1
- package/references/zhipin-workflows.md +28 -5
|
@@ -4,6 +4,29 @@
|
|
|
4
4
|
|
|
5
5
|
`conversationId` / `candidateId` 是跨 tool 的稳定主键，`index` 只表示当前 DOM 快照。
|
|
6
6
|
|
|
7
|
+
## 多账号 browserInstance 作用域
|
|
8
|
+
|
|
9
|
+
多 Boss 账号托管时，`browserInstance` 是账号/profile 路由键。orchestrator 必须把它贯穿同一账号任务的所有 browser-use 调用。
|
|
10
|
+
|
|
11
|
+
作用域规则：
|
|
12
|
+
|
|
13
|
+
1. 同一个账号线程固定一个 `browserInstance`，例如 `boss-a`。
|
|
14
|
+
2. 该线程中的 `zhipin_*`、`browser_snapshot`、`click_ref`、`type_ref`、`list_pages`、`select_page` 都显式传同一个 `browserInstance`。
|
|
15
|
+
3. `conversationId` / `candidateId` 是业务主键，但不替代 `browserInstance`；同一个候选会话仍必须在正确账号 profile 中执行。
|
|
16
|
+
4. `pageId`、`@eN`、`@cN`、`@jN`、`jobRef`、`candidateRef`、`preparedReplyId` 只在产生它们的 `browserInstance` 内有效。
|
|
17
|
+
5. 多实例没有 `browser.defaultInstance` 时，不传 `browserInstance` 的调用会返回 `needs_input`。
|
|
18
|
+
6. 不要把 `boss-a` 生成的 `preparedReplyId` 交给 `boss-b` 发送；发送工具会校验当前页面目标和招聘者绑定。
|
|
19
|
+
|
|
20
|
+
示例：
|
|
21
|
+
|
|
22
|
+
```json
|
|
23
|
+
{
|
|
24
|
+
"browserInstance": "boss-a",
|
|
25
|
+
"conversationId": "610630074-0",
|
|
26
|
+
"maxMessages": 100
|
|
27
|
+
}
|
|
28
|
+
```
|
|
29
|
+
|
|
7
30
|
## BOSS 页面入口
|
|
8
31
|
|
|
9
32
|
`navigate_active_tab(url)` 是通用 native CDP 导航工具，但不能直接跳转 BOSS `/web/chat/*` 后台路径。
|
|
@@ -25,10 +48,9 @@
|
|
|
25
48
|
推荐做法：
|
|
26
49
|
|
|
27
50
|
1. `zhipin_read_messages` 记录 `conversationId + candidateId + candidateName`。
|
|
28
|
-
2. `
|
|
29
|
-
3. `
|
|
30
|
-
4. `
|
|
31
|
-
5. `zhipin_send_reply(signedEnvelope)`。
|
|
51
|
+
2. `zhipin_generate_reply_preview({ browserInstance, conversationId })`。
|
|
52
|
+
3. `zhipin_send_prepared_reply({ browserInstance, preparedReplyId })`。
|
|
53
|
+
4. 发送后用 `zhipin_read_messages({ browserInstance, onlyUnread:true })` 或目标会话读取做验证。
|
|
32
54
|
|
|
33
55
|
## 推荐岗位筛选
|
|
34
56
|
|
|
@@ -120,7 +142,7 @@ recommend-list -> 推荐牛人列表，默认向下滚动，去重主键 candid
|
|
|
120
142
|
|
|
121
143
|
## Reply Authority
|
|
122
144
|
|
|
123
|
-
`
|
|
145
|
+
`zhipin_send_prepared_reply` 只接受 `zhipin_generate_reply_preview` 生成的 `preparedReplyId`，内部再取回 Reply Authority Service 签发的 envelope 并完成验签。
|
|
124
146
|
|
|
125
147
|
发送前校验：
|
|
126
148
|
|
|
@@ -130,6 +152,7 @@ recommend-list -> 推荐牛人列表，默认向下滚动，去重主键 candid
|
|
|
130
152
|
4. replay `jti` 是否已消费。
|
|
131
153
|
5. 当前选中聊天是否匹配 `conversationId + candidateId`。
|
|
132
154
|
6. 当前登录招聘者是否匹配 `recruiterBinding`。
|
|
155
|
+
7. 当前 `browserInstance` 是否仍是生成 `preparedReplyId` 的账号/profile 作用域。
|
|
133
156
|
|
|
134
157
|
`generate_reply` 的 `target` 两种模式：
|
|
135
158
|
|