Wuying AgentBay Cloud Infrastructure Platform

English | 中文

Synopsis

Alibaba Cloud's Wuying AgentBay constitutes a dedicated cloud environment tailored specifically for the operation of autonomous AI agents. It furnishes enterprises, software developers, and specialized AI vendors with an expedient, single-click toolchain and operational sandbox for executing agentic tasks. Via the AgentBay Management Server interface or its dedicated API, agent applications can rapidly incorporate and leverage requisite external tools, operating in a dynamically scaled, serverless cloud setting.

Understanding Wuying (The Foundation)

Wuying (meaning 'Shadowless'), also referenced as Alibaba Cloud Workspace, represents Alibaba Cloud's novel architecture merging cloud networking and compute capabilities. It delivers secure, high-performance computing experiences leveraging virtualized desktops, applications, and thin clients. Its core attributes include:

• Fortified Security Posture
• Zero Operational Overhead (Maintenance-free)
• Lightweight Asset Footprint
• Simplified System Integration
• Low-Latency Global Accessibility

AgentBay Defined

AgentBay is the specialized layer atop Wuying infrastructure dedicated to supporting AI Agents. It offers:

• Provisioning tools for agent task execution via one-step configuration.
• Isolated, secure execution sandboxes.
• Enterprise-grade infrastructural foundation for development entities and AI providers.
• Rapid integration pathways using the SDK and the Management Server Protocol (MCP).
• Native serverless compute capabilities.

Principal Capabilities

1. Standardized Operational Runtime
2. Pre-configured standard utilities essential for agent operations.
3. Encapsulation via the Model Context Protocol (MCP).

4. Accelerating enterprise adoption through streamlined integration.

5. User Context Preservation

6. Secure segmentation and storage for user credentials and session data (cookies).
7. Dynamic injection of preserved user states into new sessions.

8. Environment simulation closely matching local client setups.

9. Immediate Edge-to-Cloud Communication

10. Proprietary ASP protocol facilitating low-latency data streaming between the cloud backend and the client device.
11. Capability to recognize and manage peripheral access on the local endpoint.
12. Dedicated channels for network traffic and input/output device redirection.

System Topology

• Stateful Persistence Layer: Utilizes bespoke persistent storage mechanisms to maintain user configurations and session artifacts across invocations.
• Communication Backbone: Employs the unique ASP protocol for synchronous, real-time data exchange between the cloud compute environment and the terminal client.
• Scalability: Infrastructure designed to burst capacity up to 10,000 concurrent operations within seconds, leveraging Alibaba Cloud's vast resource pool.
• Service Delivery: Operates under a serverless model, providing session management and environment setup automatically upon request.
• Toolset Integration: Supports integration with core MCP utilities: Web Browser, File System Access, and Terminal access.
• Access Methods: Configurable via direct SDK+API calls or through the MCP Server interface.

Cloud Service Parameters

Compute Assets

The service utilizes shared elastic resources. A limited complimentary usage tier is available during the public preview phase, restricted to a maximum of 10 concurrent instances. Geographic region assignment is automatically determined based on the client's ingress IP address.

Runtime Image Specification

The platform is initialized using curated Linux version images. Wuying actively enhances and updates these base images while strictly maintaining compatibility across successive releases.

Supported MCP Utilities

The initial deployment package natively features the Browser, File, and Terminal tools. For the most current listing and updates on supported utilities, consult the official product portal.

Initial Setup Guide

Phase 1: Generating Credentials

Secure an API authentication key for service access.

1. Navigate to the AgentBay Control Console.
2. In the left-hand navigation pane, select Service Management.
3. On the Service Management dashboard, initiate the creation of an API KEY.
4. Input a descriptive label in the creation dialogue and confirm.

Caveat: During this preview period, the maximum number of active API Keys is capped at 10. The newly generated key will appear in the service management list; retain this credential securely.

Phase 2: Configuring the MCP Runtime

Verify the operational environment parameters and retrieve the necessary MCP connection string.

1. Access the AgentBay Control Console.
2. Select Configure Resources from the primary navigation menu.
3. Choose the previously generated API Key from the API Key selection field.
4. Select the desired operational image from the Select Image dropdown.

Note: The system defaults to pre-built Linux images. Wuying maintains an evolving library of images, prioritizing downward compatibility.

1. Examine the Tool Capabilities and Interface section to see enabled MCP functionalities. Click View for comprehensive specification sheets.
2. In the Obtain MCP Information terminal pane, use the Copy Code button to acquire the configuration snippet. This code must be integrated into MCP-compatible client applications (e.g., Cline, Cursor).

Example integration using Cursor Version 0.48.9:

• Open Cursor's Settings interface and navigate to the MCP section.
• In the MCP Servers area, click Add new global MCP server.
• Paste the copied configuration into the newly opened mcp.json file and save. Supported communication protocols include SSE (Server-Sent Events) and STDIO.

Crucial: Substitute YOUR_API_KEY with the actual key obtained in Step 1 (it begins with akm-).

Configuration using the SSE transport method (relying on persistent connection initiation without local plugin installation):

{
  "mcpServers": {
    "wuying_mcp_server": {
      "url": "https://agentbay.wuying.aliyun.com/sse?APIKEY=YOUR_API_KEY"
    }
  }
}

Upon task termination, the cloud session may be decommissioned. To preserve the working environment and configuration for subsequent sessions, append the EXTERNALID parameter to the URL. Example:

{
  "mcpServers": {
    "wuying_mcp_server": {
      "url": "https://agentbay.wuying.aliyun.com/sse?APIKEY=YOUR_API_KEY&EXTERNALID=user001"
    }
  }
}

Phase 3: Activating Visual Streaming (Optional)

Visual access to the cloud desktop session is achievable either by embedding the Wuying Web SDK within an iframe or by direct invocation of the Wuying Web client through a standard browser. When the visual stream is requested via MCP, the system returns a pre-authenticated URL structure: https://wuying.aliyun.com?mcp.html?authcode=<authCode>&resourceId=<resourceId>.

• This authorization link possesses time and usage limitations; prompt execution is advised.
• Interaction controls (mouse/keyboard) can be enabled by appending parameters like &input=true&keyboard=true to the URL, or managed dynamically via the Web SDK interface. Consult the Web SDK Documentation for exhaustive details.

Next Steps

Validate the setup by issuing a command such as "launch the web browser via wuying-agentbay and navigate to wuying.aliyun.com". If correctly provisioned, the Wuying cloud session will initialize, and browser actions will execute remotely. During this process, the AI model will present a Web link, enabling you to open the Wuying visual stream and assume interactive control if necessary.

License

MIT

Assistance

For troubleshooting or further inquiry, access these resources: - Alibaba Cloud Wuying Official Documentation - AgentBay Product Information Page

WIKIPEDIA: Cloud computing is "a paradigm for enabling network access to a scalable and elastic pool of shareable physical or virtual resources with self-service provisioning and administration on-demand," according to ISO. It is commonly referred to as "the cloud".

== Characteristics == In 2011, the National Institute of Standards and Technology (NIST) identified five "essential characteristics" for cloud systems. Below are the exact definitions according to NIST:

On-demand self-service: "A consumer can unilaterally provision computing capabilities, such as server time and network storage, as needed automatically without requiring human interaction with each service provider." Broad network access: "Capabilities are available over the network and accessed through standard mechanisms that promote use by heterogeneous thin or thick client platforms (e.g., mobile phones, tablets, laptops, and workstations)." Resource pooling: " The provider's computing resources are pooled to serve multiple consumers using a multi-tenant model, with different physical and virtual resources dynamically assigned and reassigned according to consumer demand." Rapid elasticity: "Capabilities can be elastically provisioned and released, in some cases automatically, to scale rapidly outward and inward commensurate with demand. To the consumer, the capabilities available for provisioning often appear unlimited and can be appropriated in any quantity at any time." Measured service: "Cloud systems automatically control and optimize resource use by leveraging a metering capability at some level of abstraction appropriate to the type of service (e.g., storage, processing, bandwidth, and active user accounts). Resource usage can be monitored, controlled, and reported, providing transparency for both the provider and consumer of the utilized service. By 2023, the International Organization for Standardization (ISO) had expanded and refined the list.

== History ==

The history of cloud computing extends to the 1960s, with the initial concepts of time-sharing becoming popularized via remote job entry (RJE). The "data center" model, where users submitted jobs to operators to run on mainframes, was predominantly used during this era. This was a time of exploration and experimentation with ways to make large-scale computing power available to more users through time-sharing, optimizing the infrastructure, platform, and applications, and increasing efficiency for end users. The "cloud" metaphor for virtualized services dates to 1994, when it was used by General Magic for the universe of "places" that mobile agents in the Telescript environment could "go". The metaphor is credited to David Hoffman, a General Magic communications specialist, based on its long-standing use in networking and telecom. The expression cloud computing became more widely known in 1996 when Compaq Computer Corporation drew up a business plan for future computing and the Internet. The company's ambition was to superch