@ego-z/contracts 0.15.21 → 0.15.22
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/package.json +1 -1
- package/src/ask.d.ts +35 -0
package/package.json
CHANGED
package/src/ask.d.ts
CHANGED
|
@@ -266,6 +266,41 @@ export interface AskRequestBody {
|
|
|
266
266
|
*/
|
|
267
267
|
tools?: string[];
|
|
268
268
|
|
|
269
|
+
/**
|
|
270
|
+
* Tools a turn narrowed by `tools` may still load, by group.
|
|
271
|
+
*
|
|
272
|
+
* - omitted → the turn has exactly `tools` (unchanged).
|
|
273
|
+
* - a map → each key names a group, each value lists the tool names it
|
|
274
|
+
* adds. The turn is offered one more built-in,
|
|
275
|
+
* `load_tools({ groups })`; when the model calls it, the
|
|
276
|
+
* named groups' tools join the turn for its remaining steps.
|
|
277
|
+
* The next turn starts from `tools` again.
|
|
278
|
+
*
|
|
279
|
+
* ── Why it exists ────────────────────────────────────────────────────
|
|
280
|
+
*
|
|
281
|
+
* A caller that narrows each turn to the tools it most likely needs, to
|
|
282
|
+
* keep every model call small, can guess wrong. Without a way out, the
|
|
283
|
+
* narrowed turn cannot reach the tool it turns out to need and answers
|
|
284
|
+
* that it can't. With one, the model loads that group and carries on in
|
|
285
|
+
* the same turn, at the cost of one step.
|
|
286
|
+
*
|
|
287
|
+
* ── What it does NOT do ──────────────────────────────────────────────
|
|
288
|
+
*
|
|
289
|
+
* The same rule as `tools`: it never adds a tool the project has not
|
|
290
|
+
* enabled, and an unknown name is ignored. Tenant tools only: a built-in
|
|
291
|
+
* is reached through `tools`, never through a group.
|
|
292
|
+
*
|
|
293
|
+
* Needs `tools` (without it the turn already has every tool). At most 16
|
|
294
|
+
* groups; a group name is 1 to 40 letters, digits, `_` or `-`, and the
|
|
295
|
+
* model reads it, so name groups by what they are for (`website`,
|
|
296
|
+
* `orders`); each group lists 1 to 64 non-empty names. Anything else is a
|
|
297
|
+
* 400, and so is `toolGroups` with `completion: true`. `null` is treated
|
|
298
|
+
* as omitted.
|
|
299
|
+
*
|
|
300
|
+
* Optional and additive: omit it and nothing changes.
|
|
301
|
+
*/
|
|
302
|
+
toolGroups?: Record<string, string[]>;
|
|
303
|
+
|
|
269
304
|
/**
|
|
270
305
|
* What the user has on screen RIGHT NOW — sent on every turn, not just
|
|
271
306
|
* when the conversation started.
|