AgentScope Java Files

This release focuses on strengthening Skill & Prompt Management with upgraded Nacos integrations, expanding Model & Voice capabilities, and improving the stability of agent execution flows and OpenAI model interactions.

🌟 Key Highlights

Full Integration with Nacos AI Registry (v3.2.0-BETA)

AgentScope-Java v1.0.10 now fully supports the Nacos AI Registry, enabling seamless runtime access to centrally managed Prompts and Skills — empowering dynamic, cloud-native agent orchestration without redeployment.

• Prompt Runtime Binding via NacosPromptListener: Agents can dynamically fetch and render prompts from Nacos Config Center using variable substitution. Supports real-time updates — modify your prompt template in Nacos console, and agents automatically reflect changes on next call.

• Dual Skill Loading Strategies:

• Offline Mode (FileSystemSkillRepository): Use nacos-cli skill-sync to sync skills locally, then load via file system — ideal for CI/CD or air-gapped environments.
• Online Mode (NacosSkillRepository): Directly pull or subscribe to skills from Nacos at runtime via AiService, supporting hot-swapping and versioned skill management.

2. Enhanced Agent & Tool Execution

Agent workflows and tool calling mechanisms have been refined for better reliability and control.

• Completions Tool Schema: Added support for tool schema in the completions chat API, bridging the gap for complex tool definitions (#508).
• ReActAgent Improvements: Fixed an issue in ReActAgent to ensure tool calls can properly reach the acting phase for correct error handling (#850), and updated it to explicitly output MAX_ITERATIONS messages when the iteration limit is reached (#839).
• Sorted Hooks: Introduced sorting capabilities for agent hooks, allowing developers to precisely control the execution order of custom lifecycle hooks (#793).

🚀 New Features

• Model & Voice:
• TTS Support: Added a Text-to-Speech (TTS) voice enum and integrated TTS capabilities into the Werewolf game example (#749).
• Qwen & Endpoints: Allowed manual endpoint type configuration and added official support for the qwen3.5-plus model (#824).

• Format Parsing: Updated response parsing to support the new v1.1 format (#854).

• Interaction & Examples:

• HITL UI Example: Added a new Human-in-the-Loop (HITL) interactive UI example featuring a virtual fitness coach (#832).

🛠️ Refactoring & Fixes

• OpenAI & Core Models:
• Token Configuration: Fixed an issue where max_tokens and max_completion_tokens were set simultaneously, which caused conflicts in OpenAI requests (#906).
• Streaming: Fixed an issue where OpenAIChatModel stream responses would fail (#886).

• Conversation History: Ensured that all messages are correctly included in the conversation history for the OpenAI formatter (#844).

• Skill Management Fixes:

• Multi-module Projects: Resolved a bug where ClasspathSkillRepository failed to load skills in multi-module Java projects (#837).
• SkillBox Prompts: Fixed an issue to ensure skillBox prompts are properly merged into system prompts (#895).

• File System Repositories: Corrected an issue where skill fileSystem base repository sources improperly contained colons (:) (#896).

• Protocol & Infrastructure:

• MCP Conversion: Fixed Model Context Protocol (MCP) JSON schema conversion to properly preserve $defs and definitions fields (#903).
• Code Formatting: Standardized code formatting across the repository using the Spotless plugin (#822).
• Dependencies: Bumped various dependencies including Spring Boot, Jackson, Mockito, and Qdrant to their latest stable versions for improved security and performance.

❤️ New Contributors

• @azhsmesos made their first contribution in [#793]
• @luoxiner made their first contribution in [#850]
• @qiacheng7 made their first contribution in [#902]
• @wandering4 made their first contribution in [#886]
• @darkwu made their first contribution in [#906]

Full Changelog: https://github.com/agentscope-ai/agentscope-java/compare/v1.0.9...v1.0.10