OceanBase
English日本語简体中文
Docs Home
Products
Integrations
Release Notes

Databases

OceanBase DatabaseOceanBase AI DatabaseOceanBase Cloud OceanBase Best Practices

Tools

OceanBase Cloud PlatformOceanBase Migration ServiceOceanBase Developer CenterOceanBase Migration AssessmentOceanBase Admin ToolOceanBase Loader and DumperOceanBase DeployerKubernetes operator for OceanBaseOceanBase Diagnostic Tool OceanBase Binlog ServiceOceanBase DataPilotOceanBase OAgent

Connectors and Middleware

OceanBase Database Proxy OceanBase Connector/C OceanBase Connector/J OceanBase Connector/ODBC OceanBase Connector/NETOceanBase Command-Line Client

Databases

OceanBase DatabaseOceanBase AI DatabaseOceanBase Cloud OceanBase Best Practices

Connectors and Middleware

OceanBase Database Proxy OceanBase Connector/C OceanBase Connector/J OceanBase Connector/ODBC OceanBase Connector/NETOceanBase Command-Line Client

Tools

OceanBase Cloud PlatformOceanBase Migration ServiceOceanBase Developer CenterOceanBase Migration AssessmentOceanBase Admin ToolOceanBase Loader and DumperOceanBase DeployerKubernetes operator for OceanBaseOceanBase Diagnostic Tool OceanBase Binlog ServiceOceanBase DataPilotOceanBase OAgent
OceanBase DatabaseOceanBase Cloud ToolsConnectors and MiddlewareLifecycle Support Policy

OceanBase OAgent

V2.2.0
  • Product overview
    • What is OAgent?
    • Key features
    • System architecture
    • Use cases
  • Quick start
  • Deployment
  • Overview
  • Sessions and diagnosis
    • Manage sessions
    • Switch dialogue models
    • Use @ to mention the analysis target
    • View the tool invocation process
    • Upload an attachment
    • Data visualization
    • FAQ
    • Export a report
  • Tools
  • Skill Management
  • Channel management
  • Knowledge base
    • Built-in knowledge base
    • Custom knowledge base
  • Scheduled tasks
    • Overview of scheduled tasks
    • Create a scheduled task
  • View usage
  • Model configuration
    • Manage model services
    • Model scoring
  • Settings and security
    • Product management
    • Experimental features
  • Best practices
    • Perform a cluster health inspection
    • Query cluster and topology information
    • Query resource metrics and task status
    • Read-only queries
    • Alert query and troubleshooting guide
    • Root cause analysis of exceptions
    • ASH diagnostic report
    • Analyze slow SQL, TopSQL, and abnormal SQL
    • SQL pre-analysis and tuning recommendations
    • Interpret execution plans
    • Diagnostic information statistics
    • Parameter check and change governance
    • Database change ticket
  • Appendix
    • Feature list
    • Built-in Skills
  • Release notes
    • OAgent V2.2.0 Release note
    • OAgent V2.1.0 Release note
    • OAgent V2.0.0 Release note
    • OAgent V1.8.0 Release note

Download PDF

Document Feedback
  1. Documentation Center
  2. OceanBase OAgent
  3. V2.2.0

Manage sessions

Last Updated:2026-11-20 07:25:11

Create a session
Bind analysis objects
Rewind historical sessions
Copy analysis results

The session workspace is the core interface for interacting with OAgent. This topic describes how to create, bind, and rewind a session.

Create a session

  1. In the left-side navigation pane, click Create Session.

  2. Enter your request in the input field. For example, you can ask which clusters are in an OCP. Press Enter to send it.

    You can also click the shortcut scenario entry at the bottom of the input field (such as Components and Environments, Cluster Health Check, Alert Analysis, SQL Diagnostics, Root Cause Analysis of Exceptions, Capacity Planning, or Create Scheduled Task). The system will automatically fill in the corresponding question template, and you can then add information such as the cluster and time range.

Note

Press Shift + Enter in the input field to start a new line. Type / to invoke a skill. Type @ to select a component, cluster, or tenant.

Bind analysis objects

Each session can independently bind different products and clusters. After binding, tool calls within that session will automatically use the bound connection information, cluster, and tenant parameters, eliminating the need to repeatedly provide the cluster address and credentials with each query.

There are two ways to bind:

  • When asking questions, use @ to target the component, cluster, or tenant. For details, see Use @ to mention analysis objects.

  • Directly mention the product name in your query (for example, OCP_TEST or ocp2). The system will automatically match the corresponding environment.

After a session is successfully bound, the currently bound component label is displayed at the top of the session page, for example, Component · OCP_TEST.

Rewind historical sessions

The Session Record section below the left navigation pane lists historical sessions in descending order of last activity:

  • Click a session name to view the complete conversation content, tool call process, and analysis conclusion of that session.

  • When continuing to ask questions in an open session, the Agent will continue the context of that session (including the bound cluster and tenant), eliminating the need to repeatedly specify the analysis object.

Copy analysis results

Above each answer output by the Agent, there is a Copy Markdown button. Click this to copy the answer content (including tables) in Markdown format, making it easy to paste into duty logs, failure review documents, or tickets.

Previous topic

Overview
Last

Next topic

Switch dialogue models
Next
on this page
Create a session
Bind analysis objects
Rewind historical sessions
Copy analysis results