SystemMessage
public final class SystemMessage extends Msgio/agentscope/core/message/SystemMessage.java:35–172系统消息，在智能体、模型与前端之间传递结构化消息和事件。位于 io.agentscope.core.message 包，继承自 Msg。核心成员包括 builder、SystemMessage。
A Msg with MsgRole#SYSTEM pinned at construction time.
Provides convenience constructors that take a String directly
(wrapped into a TextBlock). System messages are restricted to text
blocks by Msg's validator; passing non-text blocks will throw
IllegalArgumentException.
Also offers an independent Builder for cases that need to set
metadata, timestamp, usage or generateReason.
嵌套类摘要Nested Class Summary
| 类Class | 类型Kind | 说明Description |
|---|---|---|
Builder | 类class | 构建器，用于构建并配置目标实例。 Fluent builder for `SystemMessage`. |
构造器摘要Constructor Summary
| 构造器Constructor | 说明Description |
|---|---|
public SystemMessage(String text) | 初始化 `SystemMessage` 实例。 Creates a new instance. |
public SystemMessage(String name, String text) | 初始化 `SystemMessage` 实例。 Creates a new instance. |
public SystemMessage(ContentBlock... blocks) | 初始化 `SystemMessage` 实例。 Creates a new instance. |
public SystemMessage(String name, ContentBlock... blocks) | 初始化 `SystemMessage` 实例。 Creates a new instance. |
public SystemMessage(List<ContentBlock> blocks) | 初始化 `SystemMessage` 实例。 Creates a new instance. |
方法摘要Method Summary
| 方法Method | 说明Description |
|---|---|
public static Builder builder()static | 返回构建器实例。 Creates a builder for `SystemMessage` with a randomly generated ID
and the current timestamp pre-populated. |
构造器详情Constructor Detail
SystemMessage
public SystemMessage(String text)初始化 SystemMessage 实例。
Creates a new instance.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
text | String | 文本（类型 `String`）。The text. |
io/agentscope/core/message/SystemMessage.java:37–39SystemMessage
public SystemMessage(String name, String text)初始化 SystemMessage 实例。
Creates a new instance.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
name | String | 名称（类型 `String`）。The name. |
text | String | 文本（类型 `String`）。The text. |
io/agentscope/core/message/SystemMessage.java:41–50SystemMessage
public SystemMessage(ContentBlock... blocks)初始化 SystemMessage 实例。
Creates a new instance.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
blocks varargs | ContentBlock... | 内容块列表（类型 `ContentBlock...`）。The blocks. |
io/agentscope/core/message/SystemMessage.java:52–54SystemMessage
public SystemMessage(String name, ContentBlock... blocks)初始化 SystemMessage 实例。
Creates a new instance.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
name | String | 名称（类型 `String`）。The name. |
blocks varargs | ContentBlock... | 内容块列表（类型 `ContentBlock...`）。The blocks. |
io/agentscope/core/message/SystemMessage.java:56–65SystemMessage
public SystemMessage(List<ContentBlock> blocks)初始化 SystemMessage 实例。
Creates a new instance.
| 名称Name | 类型Type | 说明Description |
|---|---|---|
blocks | List<ContentBlock> | 内容块列表（类型 `List`）。The blocks. |
io/agentscope/core/message/SystemMessage.java:67–69方法详情Method Detail
builder
public static Builder builder()返回构建器实例。
Creates a builder for SystemMessage with a randomly generated ID and the current timestamp pre-populated.
Builderio/agentscope/core/message/SystemMessage.java:86–88嵌套类详情Nested Class Detail
Builder
public static final class Builder extends Msg.Builder构建器，用于构建并配置目标实例。位于 io.agentscope.core.message 包，继承自 Msg.Builder。核心成员包括 role、id、name、content、textContent、metadata。
Fluent builder for SystemMessage. The role is fixed to
MsgRole#SYSTEM and #role(MsgRole) is unsupported.
继承成员Inherited Members
MsgbuilderForRole, generateId, currentTimestamp, getId, getName, getRole, getContent, getMetadata, getTimestamp, getUsage, hasContentBlocks, getContentBlocks, getFirstContentBlock, getFirstContentBlock, hasStructuredData, getStructuredData, getStructuredData, getTextContent, getChatUsage, getGenerateReason, withGenerateReason, withContent, withMetadata, METADATA_GENERATE_REASON, METADATA_CONFIRM_RESULTS, METADATA_CONFIRM_REQUEST_REPLY_ID, METADATA_EXTERNAL_EXECUTION_REQUEST_REPLY_ID, METADATA_SYNTHETIC, METADATA_REMINDER_KIND