ModelAssistantToolMessage

CORE · type · 类型合同

Assistant turn that may declare tool calls and may carry an empty text body.

导入

TypeScript

import type { ModelAssistantToolMessage } from '@jangts/agent-core/types';

JavaScript

/** @typedef {import('@jangts/agent-core/types').ModelAssistantToolMessage} ModelAssistantToolMessage */

其他公开入口：@jangts/agent-core/types、@jangts/agent-core/structs。

定义

类型： ModelAssistantToolMessage

类型表达式

type ModelAssistantToolMessage = ModelMessage & {
  readonly role: 'assistant';
  readonly toolCalls?: readonly ModelToolCall[];
  readonly toolCallId?: never;
  readonly images?: never;
};

字段结构

字段	类型	必需	说明
role	"assistant"	必需	见类型定义及调用场景。
content	string	必需	Rendered text content sent to the model.
images	undefined	可省略	User-supplied visual input. Binary payload is separate from the text character budget.
toolCalls	readonly ModelToolCall[] | undefined	可省略	Tool declarations made by an assistant turn; rejected on every other role at runtime.
toolCallId	undefined	可省略	Call id answered by a tool result; rejected on every other role at runtime.

类型使用

在调用方读取该合同

TypeScript

import type { ModelAssistantToolMessage } from '@jangts/agent-core/types';

// 在使用点保留原合同，TS 与 JS 具有相同的运行行为。
function inspect(value: ModelAssistantToolMessage) {
  return value.role;
}

JavaScript

/** @param {import('@jangts/agent-core/types').ModelAssistantToolMessage} value */
function inspect(value) {
  return value.role;
}

相关定义

• ModelMessage
• ModelToolCall