程序包 io.agentscope.core.message

类 Msg.Builder

java.lang.Object
io.agentscope.core.message.Msg.Builder
直接已知子类:
AssistantMessage.Builder, SystemMessage.Builder, ToolResultMessage.Builder, UserMessage.Builder
封闭类:
Msg
public static class Msg.Builder extends Object

  • 字段详细资料

  • 构造器详细资料

    • Builder

      public Builder()
      Creates a new builder with a randomly generated message ID.

  • 方法详细资料

    • id

      public Msg.Builder id(String id)
      Sets the unique identifier for the message.
      参数:
      id - The message ID
      返回:
      This builder for chaining

    • name

      public Msg.Builder name(String name)
      Sets the optional name for the message.
      参数:
      name - The message name
      返回:
      This builder for chaining

    • role

      public Msg.Builder role(MsgRole role)
      Sets the role for the message.
      参数:
      role - The message role (user, assistant, system, or tool)
      返回:
      This builder for chaining

    • content

      public Msg.Builder content(List<ContentBlock> content)
      Set content from a list of content blocks.
      参数:
      content - List of content blocks
      返回:
      This builder

    • content

      public Msg.Builder content(ContentBlock block)
      Set content from a single content block (convenience method). The block will be wrapped in a list automatically.
      参数:
      block - Single content block
      返回:
      This builder

    • content

      public Msg.Builder content(ContentBlock... blocks)
      Set content from varargs content blocks (convenience method).
      参数:
      blocks - Content blocks
      返回:
      This builder

    • textContent

      public Msg.Builder textContent(String text)
      Set text content from a string.
      参数:
      text - Text content
      返回:
      This builder

    • metadata

      public Msg.Builder metadata(Map<String,Object> metadata)
      Set metadata for structured output.
      参数:
      metadata - Metadata map
      返回:
      This builder

    • timestamp

      public Msg.Builder timestamp(String timestamp)
      Sets the timestamp for the message.
      参数:
      timestamp - The timestamp string
      返回:
      This builder for chaining

    • usage

      public Msg.Builder usage(ChatUsage usage)
      Sets the token usage information for this message.
      参数:
      usage - The ChatUsage containing token counts
      返回:
      This builder for chaining

    • generateReason

      public Msg.Builder generateReason(GenerateReason reason)

    • build

      public Msg build()
      Builds a new message instance with the configured properties. If timestamp is not set, it will be auto-generated.
      返回:
      A new immutable message