序列化表格 (AgentsFlex)

程序包 com.agentsflex.core.agent.react
- 类 com.agentsflex.core.agent.react.ReActAgentState
  
  class ReActAgentState extends Object implements Serializable
  
  serialVersionUID:
  
  1L
  - 序列化字段
    
    continueOnActionInvokeError
    
    boolean continueOnActionInvokeError
    
    iterationCount
    
    int iterationCount
    
    maxIterations
    
    int maxIterations
    
    messageHistory
    
    List<Message> messageHistory
    
    promptTemplate
    
    String promptTemplate
    
    streamable
    
    boolean streamable
    
    userQuery
    
    String userQuery
程序包 com.agentsflex.core.document
- 类 com.agentsflex.core.document.Document
  
  class Document extends VectorData implements Serializable
  - 序列化字段
    
    content
    
    String content
    
    Document Content
    
    id
    
    Object id
    
    Document ID
    
    title
    
    String title
    
    Document title
程序包 com.agentsflex.core.memory
- 类 com.agentsflex.core.memory.DefaultChatMemory
  
  class DefaultChatMemory extends Object implements Serializable
  - 序列化字段
    
    id
    
    Object id
    
    messages
    
    List<Message> messages
程序包 com.agentsflex.core.message
- 类 com.agentsflex.core.message.AbstractTextMessage
  
  class AbstractTextMessage extends Message implements Serializable
  - 序列化字段
    
    content
    
    String content
- 类 com.agentsflex.core.message.AiMessage
  
  class AiMessage extends AbstractTextMessage<AiMessage> implements Serializable
  - 序列化字段
    
    completionTokens
    
    Integer completionTokens
    
    finished
    
    Boolean finished
    
    finishReason
    
    String finishReason
    
    LLM 响应结束的原因（如 "stop", "length", "tool_calls" 等），符合 OpenAI 等主流 API 的 finish_reason 语义。
    
    fullContent
    
    String fullContent
    
    fullReasoningContent
    
    String fullReasoningContent
    
    index
    
    Integer index
    
    localCompletionTokens
    
    Integer localCompletionTokens
    
    localPromptTokens
    
    Integer localPromptTokens
    
    localTotalTokens
    
    Integer localTotalTokens
    
    promptTokens
    
    Integer promptTokens
    
    reasoningContent
    
    String reasoningContent
    
    stopReason
    
    String stopReason
    
    toolCalls
    
    List<ToolCall> toolCalls
    
    totalTokens
    
    Integer totalTokens
- 类 com.agentsflex.core.message.Message
  
  class Message extends Metadata implements Serializable
- 类 com.agentsflex.core.message.SystemMessage
  
  class SystemMessage extends AbstractTextMessage<SystemMessage> implements Serializable
- 类 com.agentsflex.core.message.ToolCall
  
  class ToolCall extends Object implements Serializable
  - 序列化字段
    
    arguments
    
    String arguments
    
    id
    
    String id
    
    name
    
    String name
- 类 com.agentsflex.core.message.ToolMessage
  
  class ToolMessage extends AbstractTextMessage<ToolMessage> implements Serializable
  - 序列化字段
    
    toolCallId
    
    String toolCallId
- 类 com.agentsflex.core.message.UserMessage
  
  class UserMessage extends AbstractTextMessage<UserMessage> implements Serializable
  - 序列化字段
    
    audioUrls
    
    List<String> audioUrls
    
    imageUrls
    
    List<String> imageUrls
    
    videoUrls
    
    List<String> videoUrls
程序包 com.agentsflex.core.model.chat
- 类 com.agentsflex.core.model.chat.ChatConfig
  
  class ChatConfig extends BaseModelConfig implements Serializable
  - 序列化字段
    
    logEnabled
    
    boolean logEnabled
    
    needReasoningContentForToolMessage
    
    Boolean needReasoningContentForToolMessage
    
    observabilityEnabled
    
    boolean observabilityEnabled
    
    retryCount
    
    int retryCount
    
    retryEnabled
    
    boolean retryEnabled
    
    retryInitialDelayMs
    
    int retryInitialDelayMs
    
    supportAudio
    
    Boolean supportAudio
    
    supportImage
    
    Boolean supportImage
    
    supportImageBase64Only
    
    Boolean supportImageBase64Only
    
    supportThinking
    
    Boolean supportThinking
    
    supportTool
    
    Boolean supportTool
    
    supportToolMessage
    
    Boolean supportToolMessage
    
    supportVideo
    
    Boolean supportVideo
    
    thinkingEnabled
    
    boolean thinkingEnabled
    
    thinkingProtocol
    
    String thinkingProtocol
- 类 com.agentsflex.core.model.chat.ChatOptions
  
  class ChatOptions extends Metadata implements Serializable
  - 序列化字段
    
    extraBody
    
    Map<String,Object> extraBody
    
    额外的模型参数，用于传递模型特有或未明确暴露的配置。例如：{"response_format": "json", "presence_penalty": 0.5} 使用 addExtraBody() 方法可方便地添加单个参数。
    
    includeUsage
    
    Boolean includeUsage
    
    是否返回 Usage 信息, 仅在 stream 模式下有效。适用于支持该特性的模型（如 Qwen3），开启后模型会返回 Usage 信息。默认为 true。
    
    maxTokens
    
    Integer maxTokens
    
    生成内容的最大 token 数量（不包括输入 prompt）。用于限制响应长度，防止生成过长内容。注意：不同模型有不同上限，超过将被截断或报错。
    
    model
    
    String model
    
    指定使用的大模型名称。例如："gpt-4", "qwen-max", "claude-3-sonnet" 等。如果未设置，将使用客户端默认模型。
    
    responseFormat
    
    Map<String,Object> responseFormat
    
    retryCount
    
    Integer retryCount
    
    retryEnabled
    
    Boolean retryEnabled
    
    retryInitialDelayMs
    
    Integer retryInitialDelayMs
    
    seed
    
    String seed
    
    随机种子（Seed），用于控制生成结果的可重复性。当 seed 相同时，相同输入将产生相同输出（前提是其他参数也一致）。注意：并非所有模型都支持 seed 参数。
    
    stop
    
    List<String> stop
    
    停止序列（Stop Sequences），当生成内容包含这些字符串时立即停止。例如：设置为 ["\n", "。"] 可在句末或换行时停止。适用于需要精确控制输出长度的场景。
    
    streaming
    
    boolean streaming
    
    是否为流式请求。这个不允许用户设置，由 Framework 自动设置（用户设置也可能被修改）。用户调用 chat 或者 chatStream 方法时，会自动设置这个字段。
    
    temperature
    
    Float temperature
    
    温度（Temperature）控制输出的随机性。
    
    值越低（如 0.1~0.3）：输出更确定、稳定、可重复，适合事实性任务（如 RAG、结构化输出）
    
    值越高（如 0.7~1.0）：输出更多样、有创意，但可能不稳定或偏离事实
    
    推荐值：
    
    文档处理、路由、工具调用：0.1 ~ 0.3
    
    问答、摘要：0.2 ~ 0.5
    
    创意写作：0.7 ~ 1.0
    
    默认值：0.5f
    
    thinkingEnabled
    
    Boolean thinkingEnabled
    
    是否启用“思考模式”（Thinking Mode）。适用于支持该特性的模型（如 Qwen3），开启后模型会显式输出推理过程。默认为 null（由模型决定）。
    
    topK
    
    Integer topK
    
    Top-k 控制生成时考虑的最高概率词的数量。模型仅从 top-k 个最可能的词中采样。 - 值为 50 表示只考虑概率最高的 50 个词 - 值越小，输出越确定；值越大，输出越多样注意：与 top_p 类似，通常不与 temperature 同时使用。
    
    topP
    
    Float topP
    
    Top-p（也称 nucleus sampling）控制生成时考虑的概率质量。模型从累积概率不超过 p 的最小词集中采样。 - 值为 1.0 表示考虑所有词（等同于无 top-p 限制） - 值为 0.9 表示只考虑累积概率达 90% 的词注意：temperature 和 top_p 不应同时调整，通常只用其一。
程序包 com.agentsflex.core.model.chat.tool
- 类 com.agentsflex.core.model.chat.tool.BaseTool
  
  class BaseTool extends Object implements Serializable
  - 序列化字段
    
    description
    
    String description
    
    name
    
    String name
    
    parameters
    
    Parameter[] parameters
- 类 com.agentsflex.core.model.chat.tool.FunctionTool
  
  class FunctionTool extends BaseTool implements Serializable
  - 序列化字段
    
    invoker
    
    Function<Map<String,Object>,Object> invoker
- 类 com.agentsflex.core.model.chat.tool.MethodParameter
  
  class MethodParameter extends Parameter implements Serializable
  
  serialVersionUID:
  
  1L
  - 序列化字段
    
    typeClass
    
    Type typeClass
    
    参数的完整类型信息（支持泛型）
- 类 com.agentsflex.core.model.chat.tool.MethodTool
  
  class MethodTool extends BaseTool implements Serializable
  - 序列化字段
    
    clazz
    
    Class<?> clazz
    
    method
    
    Method method
    
    object
    
    Object object
- 类 com.agentsflex.core.model.chat.tool.Parameter
  
  class Parameter extends Object implements Serializable
  
  serialVersionUID:
  
  1L
  - 序列化字段
    
    children
    
    List<Parameter> children
    
    defaultValue
    
    Object defaultValue
    
    description
    
    String description
    
    enums
    
    String[] enums
    
    name
    
    String name
    
    properties
    
    Map<String,Object> properties
    
    object 类型的属性定义（仅当字段有 @ToolParam 时解析） key: 字段名, value: 字段的 schema map（由序列化器直接使用）
    
    required
    
    boolean required
    
    type
    
    String type
- 类 com.agentsflex.core.model.chat.tool.ToolContext
  
  class ToolContext extends Object implements Serializable
  - 序列化字段
    
    attributes
    
    Map<String,Object> attributes
    
    tool
    
    Tool tool
    
    toolCall
    
    ToolCall toolCall
程序包 com.agentsflex.core.model.config
- 类 com.agentsflex.core.model.config.BaseModelConfig
  
  class BaseModelConfig extends Object implements Serializable
  
  serialVersionUID:
  
  1L
  - 序列化字段
    
    apiKey
    
    String apiKey
    
    customProperties
    
    Map<String,Object> customProperties
    
    endpoint
    
    String endpoint
    
    model
    
    String model
    
    provider
    
    String provider
    
    requestPath
    
    String requestPath
程序包 com.agentsflex.core.model.exception
- 异常错误 com.agentsflex.core.model.exception.ModelException
  
  class ModelException extends RuntimeException implements Serializable
程序包 com.agentsflex.core.model.image
- 类 com.agentsflex.core.model.image.ImageResponse
  
  class ImageResponse extends Metadata implements Serializable
  - 序列化字段
    
    error
    
    boolean error
    
    errorMessage
    
    String errorMessage
    
    images
    
    List<Image> images
程序包 com.agentsflex.core.model.rerank
- 异常错误 com.agentsflex.core.model.rerank.RerankException
  
  class RerankException extends RuntimeException implements Serializable
程序包 com.agentsflex.core.prompt
- 类 com.agentsflex.core.prompt.MemoryPrompt
  
  class MemoryPrompt extends Prompt implements Serializable
  - 序列化字段
    
    historyMessageTruncateEnable
    
    boolean historyMessageTruncateEnable
    
    historyMessageTruncateLength
    
    int historyMessageTruncateLength
    
    historyMessageTruncateProcessor
    
    Function<String,String> historyMessageTruncateProcessor
    
    maxAttachedMessageCount
    
    int maxAttachedMessageCount
    
    memory
    
    ChatMemory memory
    
    systemMessage
    
    SystemMessage systemMessage
    
    temporaryMessages
    
    List<Message> temporaryMessages
- 类 com.agentsflex.core.prompt.Prompt
  
  class Prompt extends Metadata implements Serializable
  - 序列化字段
    
    toolChoice
    
    String toolChoice
    
    tools
    
    List<Tool> tools
- 类 com.agentsflex.core.prompt.SimplePrompt
  
  class SimplePrompt extends Prompt implements Serializable
  - 序列化字段
    
    aiMessage
    
    AiMessage aiMessage
    
    systemMessage
    
    SystemMessage systemMessage
    
    toolMessages
    
    List<ToolMessage> toolMessages
    
    userMessage
    
    UserMessage userMessage
程序包 com.agentsflex.core.store
- 类 com.agentsflex.core.store.SearchWrapper
  
  class SearchWrapper extends VectorData implements Serializable
  - 序列化字段
    
    condition
    
    Condition condition
    
    query condition
    
    maxResults
    
    Integer maxResults
    
    search max result, like the sql "limit" in mysql
    
    minScore
    
    Double minScore
    
    The lowest correlation score, ranging from 0 to 1 (including 0 and 1). Only embeddings with a score of this value or higher will be returned. 0.0 indicates accepting any similarity or disabling similarity threshold filtering. A threshold of 1.0 indicates the need for a perfect match.
    
    outputFields
    
    List<String> outputFields
    
    query fields
    
    outputVector
    
    boolean outputVector
    
    whether to output vector data
    
    partitionNames
    
    List<String> partitionNames
    
    text
    
    String text
    
    search text, Vector store will convert the text to vector data
    
    withVector
    
    boolean withVector
    
    The flag of include vector data queries. If the current value is true and the vector content is null, the query text will be automatically converted into vector data through the vector store.
- 类 com.agentsflex.core.store.StoreOptions
  
  class StoreOptions extends Metadata implements Serializable
  - 序列化字段
    
    collectionName
    
    String collectionName
    
    store collection name
    
    embeddingOptions
    
    EmbeddingOptions embeddingOptions
    
    store embedding options
    
    indexName
    
    String indexName
    
    store index name
    
    partitionNames
    
    List<String> partitionNames
    
    store partition name
- 类 com.agentsflex.core.store.StoreResult
  
  class StoreResult extends Metadata implements Serializable
  - 序列化字段
    
    exception
    
    Exception exception
    
    ids
    
    List<Object> ids
    
    message
    
    String message
    
    success
    
    boolean success
- 类 com.agentsflex.core.store.VectorData
  
  class VectorData extends Metadata implements Serializable
  - 序列化字段
    
    score
    
    Float score
    
    0 ~ 1, 数值越大，相似度越高
    
    vector
    
    float[] vector
程序包 com.agentsflex.core.store.condition
- 类 com.agentsflex.core.store.condition.Condition
  
  class Condition extends Object implements Serializable
  - 序列化字段
    
    connector
    
    Connector connector
    
    effective
    
    boolean effective
    
    left
    
    Operand left
    
    next
    
    Condition next
    
    prev
    
    Condition prev
    
    right
    
    Operand right
    
    type
    
    ConditionType type
- 类 com.agentsflex.core.store.condition.Group
  
  class Group extends Condition implements Serializable
  - 序列化字段
    
    childCondition
    
    Condition childCondition
    
    prevOperand
    
    String prevOperand
- 类 com.agentsflex.core.store.condition.Key
  
  class Key extends Object implements Serializable
  - 序列化字段
    
    key
    
    Object key
- 类 com.agentsflex.core.store.condition.Not
  
  class Not extends Group implements Serializable
- 类 com.agentsflex.core.store.condition.Value
  
  class Value extends Object implements Serializable
  - 序列化字段
    
    condition
    
    Condition condition
    
    value
    
    Object value
程序包 com.agentsflex.core.store.exception
- 异常错误 com.agentsflex.core.store.exception.StoreException
  
  class StoreException extends RuntimeException implements Serializable
程序包 com.agentsflex.core.util
- 类 com.agentsflex.core.util.Maps
  
  class Maps extends HashMap<String,Object> implements Serializable
- 类 com.agentsflex.core.util.Metadata
  
  class Metadata extends Object implements Serializable
  
  serialVersionUID:
  
  1L
  - 序列化字段
    
    metadataMap
    
    Map<String,Object> metadataMap
    
    Internal storage: ConcurrentHashMap for thread-safety. Lazily initialized to save memory when unused.
- 异常错误 com.agentsflex.core.util.RetryException
  
  class RetryException extends RuntimeException implements Serializable
- 异常错误 com.agentsflex.core.util.TypeConverter.ConversionException
  
  class ConversionException extends RuntimeException implements Serializable

序列化表格

程序包 com.agentsflex.core.agent.react

类 com.agentsflex.core.agent.react.ReActAgentState

序列化字段

continueOnActionInvokeError

iterationCount

maxIterations

messageHistory

promptTemplate

streamable

userQuery

程序包 com.agentsflex.core.document

类 com.agentsflex.core.document.Document

序列化字段

content

id

title

程序包 com.agentsflex.core.memory

类 com.agentsflex.core.memory.DefaultChatMemory

序列化字段

id

messages

程序包 com.agentsflex.core.message

类 com.agentsflex.core.message.AbstractTextMessage

序列化字段

content

类 com.agentsflex.core.message.AiMessage

序列化字段

completionTokens

finished

finishReason

fullContent

fullReasoningContent

index

localCompletionTokens

localPromptTokens

localTotalTokens

promptTokens

reasoningContent

stopReason

toolCalls

totalTokens

类 com.agentsflex.core.message.Message

类 com.agentsflex.core.message.SystemMessage

类 com.agentsflex.core.message.ToolCall

序列化字段

arguments

id

name

类 com.agentsflex.core.message.ToolMessage

序列化字段

toolCallId

类 com.agentsflex.core.message.UserMessage

序列化字段

audioUrls

imageUrls

videoUrls

程序包 com.agentsflex.core.model.chat

类 com.agentsflex.core.model.chat.ChatConfig

序列化字段

logEnabled

needReasoningContentForToolMessage

observabilityEnabled

retryCount

retryEnabled

retryInitialDelayMs

supportAudio

supportImage

supportImageBase64Only

supportThinking

supportTool

supportToolMessage

supportVideo

thinkingEnabled

thinkingProtocol

类 com.agentsflex.core.model.chat.ChatOptions

序列化字段

extraBody

includeUsage

maxTokens