AgentBay:Manage images

Prerequisites

Custom image management is a paid feature. You must purchase a benefit package before using this feature. For more information, see Billing details.

Create an image

1. Log on to the AgentBay console.

2. In the left navigation pane, click Image Management.

3. On the Images page, click the Custom Image tab, and click Create Image.

4. In the Create Image panel, enter an image name, select an image on the System Image or Custom Image tab, and click Confirm and Start.

5. On the online creator page, create the custom image.

   1. In the Prepare Setup Environment step, wait for the environment to be prepared. When the environment is ready, a guide dialog box appears. In the dialog box, click Create.

   2. In the Create and Configure Image step, install applications, add files, or modify the registry as needed. Then, click Next.

   3. In the MCP Configuration dialog box, enable or disable services as needed, then click Next.

      You can also register a custom MCP service. Click Register Custom MCP, configure the required parameters, then click OK.

      Note

      When you register a custom MCP service, upload your MCP application to the image using the file upload feature or a cloud drive.

      Parameter	Description
      Name	Enter the MCP service name.
      Description	Enter the MCP service description.
      Icon	Click Click to Upload to upload an icon.
      Connection	STDIO
      MCP Configuration	Change the command value in the following code block to the absolute path of your MCP application in the image. Then, copy and paste the code block into the MCP Configuration input box. { "mcpServers": { "FileSystem": { "name": "FileSystem", "icon": "", "version": "1.0.0", "description": "", "detail": "https://www.alibabacloud.com/help/en/wuying-workspace/filesystem", "disabled": false, "timeout": 60, "command": "C:\Program Files (x86)\FileSystem.exe", "args": [], "transportType": "stdio" } } }

      Note

      A custom MCP service is enabled by default upon creation.

   4. In the Test dialog box, click Test Now.

      Note

      Preparing the environment for the Test and Verify step typically takes 1 to 5 minutes.

   5. After the test environment is ready, click Start Test.

   6. In the Test environment, follow the on-screen instructions to test and verify the MCP service.

   7. After the test and verification are complete, click Test Passed. In the confirmation dialog box, click Confirm.

   8. On the Test Passed page, click Publish Image. In the confirmation dialog box, click Confirm.

   9. In the dialog box that appears, click Go Now to return to the AgentBay console and view the progress and result of the image publication.

Enable an image

When you enable an image, an independent resource pool is generated from the custom image. This resource pool is revoked if it remains disconnected for more than 30 days.

Configure an image policy

After you enable an image, you can configure an image policy to control the behavior of the independent resource pool generated from that image.

1. On the Images page, click Image Policy in the Actions column for the image you enabled.

2. In the Image Policy dialog box, configure the parameters as needed, and then click OK.

   Linux

   Parameter	Description
   System Taskbar, Application Launchers, and Desktop Setting	Options: Default Reference Image Customize by Administrator
   Hide System Taskbar, Application Launchers, and Desktop	This configuration item is displayed when you set System Taskbar, Application Launchers, and Desktop Setting to Customize by Administrator. If you enable this feature, the client hides the taskbar, application launchers, and desktop from the user.
   Maximize, Minimize, and Close Button Setting	Options: Default Reference Image Customize by Administrator
   Hide the Maximize, Minimize, and Close buttons	This configuration item appears if you set Maximize, Minimize, and Close Button Setting to Customize by Administrator. If you enable this feature, the client hides the Maximize, Minimize, and Close buttons from the user.
   Full Screen Setting	Options: Default Reference Image Customize by Administrator
   Default to Full Screen	This configuration item appears only if you set Full Screen Setting to Customize by Administrator. If you enable this feature, applications open in full screen by default.

   Windows

   Configuration Item	Description
   Hide system taskbar, application entry, and desktop	If you enable this feature, the client hides the entry for the taskbar, application entry, and desktop from the user.

Stop an image

If you no longer need the independent resource pool generated from an image, you can stop the image.

1. On the Images page, find the image that you enabled, and in the Actions column, click Stop.

2. In the dialog box that appears, click Stop.

   Important

   After you stop an image, the independent resource pool generated from the image becomes unavailable. However, the image itself is retained.

Delete an image

If you no longer need an image or if the image creation failed, you can delete the image.