ToolCallCollector

CORE · interface · 类型合同

Aggregation entry point for streamed function-call deltas.

导入

TypeScript

import type { ToolCallCollector } from '@jangts/agent-core/support';

JavaScript

/** @typedef {import('@jangts/agent-core/support').ToolCallCollector} ToolCallCollector */

其他公开入口：@jangts/agent-core/support、@jangts/agent-core/support/model。

定义

interface ToolCallCollector

字段结构

字段	类型	必需	说明
push	(part: ModelPart) => void	必需	Feed one part; text parts are ignored and cannot satisfy or break a call.
calls	readonly AggregatedToolCall[]	必需	只读。Calls started so far, including incomplete ones, in index order.
complete	() => readonly AggregatedToolCall[]	必需	Finalize the calls.

成员目录

成员	用途
push	Feed one part; text parts are ignored and cannot satisfy or break a call.
complete	Finalize the calls.

成员详情

push

Feed one part; text parts are ignored and cannot satisfy or break a call.

ToolCallCollector.push(part: ModelPart): void

Feed one part; text parts are ignored and cannot satisfy or break a call.

参数	类型	传递	说明
part	ModelPart	必需	—

参数 part的可选结构： 选择其中一种结构，各分支的字段要求分别列出。

分支 1

string

分支 2

字段	类型	必需	说明
type	"function-call-delta"	必需	见类型定义及调用场景。
index	number	必需	Index of the call within the response; deltas with the same index belong together.
id	string | undefined	可省略	Provider call id, usually delivered once with the first delta.
name	string | undefined	可省略	Function name, usually delivered once with the first delta.
arguments	string | undefined	可省略	Raw JSON argument fragment; concatenating all fragments yields the full arguments.

返回： void。

complete

Finalize the calls.

ToolCallCollector.complete(): readonly AggregatedToolCall[]

Finalize the calls.

无调用参数。

返回： readonly AggregatedToolCall[]。

使用示例

• 兼容 Provider 与自定义 Provider：Support 负责常见 Chat Completions HTTP/SSE 生命周期；App 可替换为自己的 ChatProvider。
• Support：推荐用法的聚合入口：Support 聚合推荐的构造、策略与同源配置生成；Core 运行不依赖这个命名空间。

真实服务端配置接入常见协议

入门 · Node.js

运行此例需要提供可用模型服务的连接配置。

TypeScript

import { ModelRunner, Support } from '@jangts/agent-core';
const provider = new Support.CompatibleModelProvider({ config: {
  baseUrl: process.env.MODEL_BASE_URL!, apiKey: process.env.MODEL_API_KEY!, model: process.env.MODEL_NAME!,
} });
const runner = new ModelRunner({ provider });
console.log((await runner.invoke('你好')).value);

JavaScript

import { ModelRunner, Support } from '@jangts/agent-core';
const provider = new Support.CompatibleModelProvider({ config: {
        baseUrl: process.env.MODEL_BASE_URL, apiKey: process.env.MODEL_API_KEY, model: process.env.MODEL_NAME,
    } });
const runner = new ModelRunner({ provider });
console.log((await runner.invoke('你好')).value);

直连工具线程的声明字段与 wire 映射

配置 · Node.js

只演示消息转换，无网络请求或工具执行。原始 tool_calls、tool_call_id 和宿主附加数据不透传。

TypeScript

import { Support } from '@jangts/agent-core';
const messages: Support.ProviderMessage[] = [
  { role: 'user', content: '查询资料' },
  { role: 'assistant', content: '', toolCalls: [
    { id: 'call-1', name: 'lookup', arguments: '{"query":"资料"}' },
  ] },
  { role: 'tool', content: '{"found":true}', toolCallId: 'call-1' },
];
console.log(Support.chatCompletionMessages(messages));

JavaScript

import { Support } from '@jangts/agent-core';
const messages = [
    { role: 'user', content: '查询资料' },
    { role: 'assistant', content: '', toolCalls: [
            { id: 'call-1', name: 'lookup', arguments: '{"query":"资料"}' },
        ] },
    { role: 'tool', content: '{"found":true}', toolCallId: 'call-1' },
];
console.log(Support.chatCompletionMessages(messages));

相关策略源码

• HTTP 失败映射和受控请求字段

相关定义

• AggregatedToolCall
• FunctionCallDelta
• ModelPart