Release Date: October 13, 2026
Overview
Building upon the multi-user capability of V2.0.0, OAgent V2.1.0 introduces a user-level chat HTTP API, enabling external systems to initiate synchronous or asynchronous conversations via accounts. The decoupling of administrator passwords from gateway passwords results in more stable container upgrades, session restoration, and frontend rendering.
New features
User-level chat HTTP API
- Added a synchronous interface
POST /api/oagent/v1/chat, allowing callers to directly receive assistant responses after submitting a message. - Added an asynchronous interface
POST /api/oagent/v1/chat/jobs, supporting task status queries, result retrieval, and task cancellation. This is suitable for time-consuming tasks such as diagnostics, analysis, inspection, and reporting. - Uses OAgent user accounts for HTTP Basic Auth, with interface access following existing user, session, and task permissions.
- Asynchronous tasks support
Idempotency-Key, preventing duplicate task creation due to network retries. Uncompleted tasks are clearly marked as failed upon service restart, and requests that could cause side effects are not automatically replayed. - Supports specifying a model or using the current default model. When resuming an existing conversation, the model bound to that session is used, avoiding accidental model switching by the caller.
Session trajectory export
- Optimized the result feedback for the
/export-trajectoryand/trajectorycommands. - Upon successful export, the result returns to the current conversation. Timeout or failure is clearly indicated, facilitating further troubleshooting.
Experience optimization
Conversations and output
- Charts are displayed only when users explicitly request visualization. Normal diagnostic and report responses no longer automatically append tool charts.
- When resuming a conversation, switching sessions, or loading history, the most recent cached content is prioritized to reduce waiting.
- The session list supports full pagination loading, reducing duplicate requests when switching sessions.
- Optimized the logic for message bubbles, tool cards, and auto-scrolling, resulting in more stable page response for large outputs and long conversations.
Login and gateway
- Fixed the issue where repeated reconnections occurred when the Control UI and Gateway built IDs were inconsistent.
- Optimized connection recovery and session synchronization after a Gateway restart.
- Rejects duplicate usernames in advance during batch user creation, reducing the situation where some failures are discovered only after submission.
Container upgrade and deployment
- Automatically migrates the old version's shared state database upon container startup. The upgrade process no longer relies on manual state transfer.
- Unified runtime configuration for channel plugins, reducing the issue of inconsistent channel plugin states after an upgrade.
Bug fixes
Domain |
Fixed issues |
|---|---|
| HTTP Dialog API | + Fixed issues related to status handling in scenarios such as duplicate submission of asynchronous tasks, reuse of idempotent keys, and concurrent execution within the same session. + Fixed issues where task status was unclear or task result queries returned abnormal after a service restart. + Fixed an issue where unauthorized users could probe other users' resources through task or session interfaces. |
| Account and password | + Fixed the issue where the admin password and gateway password overwrite each other. + Fixed the issue where old login sessions do not expire promptly after an administrator changes or resets their password. |
| Dialogs and sessions | + Fixed the issue where the current session had no final result after trajectory export was completed. + Fixed the issues of abnormal session history loading, pagination, and resumption after disconnection. + Fixed the issue where tool calls, report links, and charts were repeatedly displayed in historical messages. |
| User Management | + Fixed the issue where the page status does not synchronize after a user logs out or their permissions change. |
| Containers and gateways | + Fixed the issue where shared state databases from earlier versions were not automatically migrated after upgrade, causing startup failures or missing states. + Fixed the issue where frontend reconnection was unstable after channel plugin configuration initialization or Gateway restart. + Fixed the issue where build version tags were missing and version information between Control UI and Gateway was inconsistent. |