必须通过http api桥接方式将agents-flex暴露为openai兼容接口供agentspace调用；启动服务并确认/v1/chat/completions可用，配置application.yml启用openai-compat-enabled与api key；在agentspace中以mcp tool注册，填写endpoint url和认证信息；通过prompt显式触发或a2a路由调用；注意5秒超时限制，长任务需配置异步超时；最后用结构化提取测试验证端到端连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在AgentSpace中使用Agents-Flex模型，必须绕过AgentSpace原生不支持Java框架直连的限制，通过HTTP API桥接方式将Agents-Flex服务暴露为可被AgentSpace调用的外部工具。
确认Agents-Flex服务已启动并开放API
启动Agents-Flex应用后，确保其内置的Spring Boot Web服务已运行在本地或内网可访问地址（如http://localhost:8080），且已启用/v1/chat/completions等标准OpenAI兼容接口。Agents-Flex 1.2.0+版本默认开启该兼容层，无需额外配置；若未启用，请检查application.yml中是否设置了agents.llm.openai-compat-enabled: true。
这一步不可跳过——AgentSpace只识别符合OpenAI API规范的HTTP端点，【Agents-Flex若仅以Java Bean形式嵌入其他服务而未暴露HTTP接口，则AgentSpace完全无法感知】。
在AgentSpace中注册Agents-Flex为MCP工具
进入AgentSpace UI → Agent Designer → 选择目标Agent → 点击“Add Tool” → 选择“MCP Tool”。
填写以下字段：
-
Name：填
agents-flex-prod（避免含空格或特殊字符） -
Endpoint URL：填
http://<your-server-ip>:8080/v1/chat/completions</your-server-ip>（注意替换IP，若部署在云服务器需确保端口放行） -
Authentication：选
API Key，Key值填Agents-Flex配置中agents.llm.api-key的实际值（如OpenAI格式的sk-xxx）
保存后，该工具会出现在Agent的可用工具列表中。AgentSpace会自动为其生成符合MCP协议的描述元数据，包括参数schema和能力声明。
配置Agent调用逻辑
方法一：在Prompt中显式触发
在Agent的系统提示词（System Prompt）末尾追加一句：“当用户问题涉及代码生成、文档解析或知识库检索时，必须优先调用agents-flex-prod工具，不得自行作答。”
方法二：通过Agent2Agent（A2A）协议路由
创建一个专用Router Agent，在其执行链中设置条件分支：若输入包含关键词“RAG”“PDF解析”“Java Skill”，则自动将请求转发至已绑定agents-flex-prod工具的Worker Agent。此方式能隔离职责，避免主Agent因错误调用导致上下文污染。
注意：AgentSpace对工具返回结果有5秒超时硬限制，若Agents-Flex处理耗时较长（如加载大PDF做RAG），需在Agents-Flex侧启用异步响应模式，并在application.yml中配置spring.mvc.async.request-timeout: 30000。
验证调用是否成功
第一步：在AgentSpace聊天界面输入测试指令：“用Agents-Flex解析这段文本：‘订单ID: ORD-789，金额￥245.60’，提取结构化JSON。”
第二步：打开Agents-Flex服务日志，确认收到HTTP POST请求，且响应体含"choices":[{...}]结构。
第三步：观察AgentSpace聊天窗口是否返回类似{"order_id":"ORD-789","amount":245.60}的格式化结果——出现即表示桥接通路已跑通。
