AS AgentScopeAPI 手册 / API Reference

OpenAIConversationMerger

public class OpenAIConversationMerger
源码Source io/agentscope/extensions/model/openai/formatter/OpenAIConversationMerger.java:47–376

OpenAI 会话 Merger,与模型服务通信并返回生成或向量化结果。位于 io.agentscope.extensions.model.openai.formatter 包。核心成员包括 mergeToUserMessage、OpenAIConversationMerger。

Merges multi-agent conversation messages for OpenAI HTTP API. Consolidates multiple agent messages into single user messages with history tags.

This class combines all agent messages into a single user message with conversation history wrapped in special tags. Images and audio are preserved as separate ContentParts.

构造器摘要Constructor Summary

构造器Constructor说明Description
public OpenAIConversationMerger(String conversationHistoryPrompt)
创建OpenAIConversationMerger 使用自定义会话历史提示词。
Create an OpenAIConversationMerger with custom conversation history prompt.

方法摘要Method Summary

方法Method说明Description
public OpenAIMessage mergeToUserMessage(List<Msg> msgs, Function<Msg, String> roleFormatter, Function<List<ContentBlock>, String> toolResultConverter)
合并到用户消息。
Merge conversation messages into a single OpenAIMessage.

构造器详情Constructor Detail

OpenAIConversationMerger

public OpenAIConversationMerger(String conversationHistoryPrompt)

创建OpenAIConversationMerger 使用自定义会话历史提示词。

Create an OpenAIConversationMerger with custom conversation history prompt.

参数Parameters
名称Name类型Type说明Description
conversationHistoryPromptString会话历史提示词(类型 `String`)。The prompt to prepend before conversation history
源码Source io/agentscope/extensions/model/openai/formatter/OpenAIConversationMerger.java:61–63

方法详情Method Detail

mergeToUserMessage

public OpenAIMessage mergeToUserMessage(List<Msg> msgs, Function<Msg, String> roleFormatter, Function<List<ContentBlock>, String> toolResultConverter)

合并到用户消息。

Merge conversation messages into a single OpenAIMessage.

参数Parameters
名称Name类型Type说明Description
msgsList<Msg>消息列表(类型 `List`)。List of conversation messages to merge
roleFormatterFunction<Msg, String>角色格式化器(类型 `Function`)。Function to format role labels (e.g., USER → "User")
toolResultConverterFunction<List<ContentBlock>, String>工具结果转换器(类型 `Function , String>`)。Function to convert tool result blocks to strings
返回Returns OpenAIMessage
返回OpenAIMessage。Single merged OpenAIMessage for OpenAI API
源码Source io/agentscope/extensions/model/openai/formatter/OpenAIConversationMerger.java:77–106
基于官方固定版本源码静态生成Generated from pinned official sources · Python 2.0.11 · Java 2.0.4
签名与文档为静态抽取;如有疑问请以源码为准。Signatures and docs are extracted statically; verify against the source when in doubt.