Skip to main content

Agents

Prerequisites​

  • Feature menu: Access to the AI Studio / Resources menu is required.
  • Operation permission: Read-Write access is required to add, remove, and update Agents; Read-Only access supports browsing and viewing details.
  • Data permission: Access to at least one resource domain under an environment is required.
  • Model configuration: Some Agents depend on LLM inference; if no model is configured, related capabilities may not work properly.

Overview​

An Agent is an AI execution unit for a specific business scenario, encapsulating reasoning logic, tool invocation, Skill collaboration, and knowledge sources. The Agents tab in Resources displays built-in Agents, publicly listed Agents, and Agents in My Resources for the current resource domain.

Agents added from Public can be invoked in Sage AI and Automation. When a new version is published, you can choose whether to upgrade; until you upgrade, your installed version continues to work without being affected by the latest public release.

image-20260821163704719

Public vs My Resources​

The Agents tab provides a Public / My Resources toggle at the top left. The two views differ in scope and actions:

AspectPublicMy Resources
What you seeBuilt-in Agents and Agents publicly listed after listing review in the resource domainAgents added in the current resource domain, plus Agents you published from Workspace
SourcePlatform presets + resources approved for public listing by other creatorsLocal copies after adding from Public, or resources published from Workspace
VisibilityBrowsable and addable by all permitted users in the resource domainInstances added or published in the current resource domain only—isolated per domain
Card actionsAdd: install the Agent into My ResourcesUse (open Sage AI), Remove (uninstall); Update when a new version is available
Details and previewView details and read-only orchestration for selectionView details, use, and manage versions; edit orchestration in Workspace
Version policyShows the latest listed public version; after adding, you choose whether to upgrade locallyAdded Agents can independently follow or defer public version upgrades
ListingAppears here after a creator’s listing request is approvedSelf-published Agents appear here by default; they enter Public only after listing approval

Typical flow: Browse Public and Add → switch to My Resources and Use or @ reference in Sage AI. After removal, the Agent is unavailable in Sage AI and Automation.

Quick classification (by tag)​

Under the search box, Resources provides tag tabs (AND with search). All is first (total resource count); then each tag with its count. One resource may appear under multiple tags. Untagged resources appear only under All. Tags with count 0 may be hidden.

Value​

  • Built-in, ready to use
    The platform provides preset Agents such as alert diagnosis, system inspection, and intelligent customer service—add and use without building from scratch.

  • Public sharing for team reuse
    Agents listed by creators appear in Public after review; other users can add them with one click for use in their resource domain.

  • Clear management in My Resources
    My Resources centralizes added and self-published Agents with use, remove, and version update actions.

  • Preview before selection
    Detail pages show basic information and read-only orchestration; autonomous Agents support debug preview to reduce selection risk.

  • Optional version upgrades
    When a new public version is available, users who added the Agent can review release notes before upgrading.

Use Cases​

Add Built-in Agents from Public​

  • Who it's for: First-time AI Studio users and teams needing standard operations capabilities.
  • Typical tasks: Add Agents such as Alert Diagnosis Assistant or System Inspection Assistant for Sage AI conversations or automated inspections.
  • Recommended approach:
    1. Go to Resources > Agents > Public;
    2. Browse or filter by scenario tags;
    3. Click Add on the target card and wait for installation;
    4. Switch to My Resources, click Use, or @ reference in Sage AI.
  • Expected outcome: The Agent is installed in the current resource domain and available in Sage AI and Automation.

Add Team-Shared Custom Agents​

  • Who it's for: Business teams that need capabilities published by other creators.
  • Typical tasks: Add a team's "Order Service Diagnosis" Agent to run analysis per team SOP.
  • Recommended approach:
    1. Search by name or description in Public;
    2. Open the detail page to review build mode, tags, default questions, and orchestration summary;
    3. Return to the list and click Add after confirming fit.
  • Expected outcome: The Agent appears in My Resources and runs per the creator's orchestration.

Use Self-Published Agents (Creators)​

  • Who it's for: Creators who develop Agents in Workspace.
  • Typical tasks: Verify visibility in Resources after publishing; self-test or share with colleagues.
  • Recommended approach:
    1. Publish the Agent in Workspace;
    2. Open Resources > Agents > My Resources and find the new resource;
    3. Click Use to try in Sage AI, or submit a listing review for others to add from Public.
  • Expected outcome: The Agent appears in My Resources; after listing approval, it appears in Public.

Version Updates and Impact Assessment​

  • Who it's for: Users with added Agents when a new public version exists; automation task owners.
  • Typical tasks: An Agent upgrades from v2.0 to v3.0—assess impact on configured automation tasks.
  • Recommended approach:
    1. Check version update indicators on My Resources cards;
    2. Click Update and read release notes and version history;
    3. Confirm upgrade; verify automation tasks referencing the Agent.
  • Expected outcome: Installed version is updated; automation tasks referencing the Agent automatically use the new version (assess change impact).

Start an Agent Conversation in Sage AI​

  • Who it's for: Daily operations and analysis staff.
  • Typical tasks: Use the Database Analysis Expert Agent to analyze slow SQL and get optimization suggestions.
  • Recommended approach:
    1. Click Use in My Resources, or select Agent in the Sage AI input area;
    2. The system loads the Agent greeting and recommended questions;
    3. Send a recommended question or customize the task description.
  • Expected outcome: A Sage AI session starts in the context of that Agent.

Operation Scenarios​

  1. Open the Agent list

    • Go to AI Studio > Resources and select the Agents tab.
    • Switch between Public and My Resources.
    • Use scenario tags, More, or advanced filters to narrow results.

  2. Read card information

    • Cards show name, version, summary, tags, add count, etc.
    • Public cards have Add at the bottom; My Resources has Remove, Use, and Update when a new version exists.

  3. Add an Agent (Public)

    • Click Add and wait for installation.
    • Some flows require confirming Add and open immediately.
    • After adding, manage the Agent in My Resources.

  4. Use / Remove (My Resources)

    • Use: Opens Sage AI and starts a conversation with the Agent.
    • Remove: Uninstalls from My Resources after confirmation; Sage AI and Automation can no longer use it.

  5. Version update (My Resources)

    • Click Update, review changes from the current to target version.
    • Confirm to complete the upgrade.

  6. View Agent details

    • Click the card body (not the footer buttons) to open the detail page.
    • Basic information: Name, summary, description, build mode, tags, default questions, etc.
    • Orchestration (step 2): Inference model, linked knowledge, MCP tools, Skills, etc. (read-only preview).
    • Workflow Agents show a read-only workflow canvas; autonomous Agents support debug preview on the right (read-only, does not modify configuration).
    • Built-in Agents support version management for history.

Getting Started​

Add and Use a Built-in Agent​

  1. Go to Resources > Agents > Public.
  2. Find the target built-in Agent and click Add.
  3. Switch to My Resources and click Use.
  4. Send a recommended question or custom task description in Sage AI.

image-20260724151828123

View Agent Details​

  1. Click the Agent card body in the list.
  2. Read content on the Basic information step.
  3. For non-built-in Agents, click Next to view Orchestration.
  4. For autonomous Agents, enter test questions in the debug panel on the right.

image-20260724151959266

Submit for Listing (Creators)​

After publishing in Workspace, the Agent appears in My Resources by default. To allow others to add from Public:

  1. Submit a listing review from Workspace or Resources (entry depends on UI).
  2. Select listing scope (resource domains) and reviewers.
  3. After approval, the Agent appears in Public for others to add.

Notes​

  • Agent lists and added resources in My Resources are isolated by resource domain; lists change when you switch domains.
  • After removing an Agent, automation tasks referencing it may fail—update task configuration promptly.
  • When an Agent publishes a new version, automation tasks referencing it automatically use the new version—read update notes before upgrading.
  • For Agents added from Public, version upgrades are optional; your installed version remains until you confirm an update.
  • Orcheation and prompts on the detail page are read-only; edit in Workspace (customize built-in Agents by cloning).