This document describes how to select an agent from the Agent Marketplace and deploy it in one click by using Agent Deployment in Compute Nest.
What is the Agent Marketplace?
The Agent Marketplace provides official sample agents. After you select an agent and complete the required fields on the deployment page, the system automatically provisions a cloud server and deploys the agent. You can then interact with the agent through a WebUI or by calling its HTTP API.
Procedure
-
Log on to Alibaba Cloud Compute Nest and navigate to .
-
Select an agent and click Deploy Now.
-
On the deployment page, configure the parameters and click Create Now.
-
After creation, you are redirected to the application page. Wait about 2 to 3 minutes for the deployment to complete.
-
On the Overview tab, open the WebUI (or use the provided access URL) to start a conversation with the agent.
Agent deployment page
Application information
-
Application name and group name: You can customize these values. In most cases, the defaults are sufficient.
Deployment resource configuration
-
Select the billing method, instance type, system disk size, and more. In most cases, the default values are sufficient.
Model configuration
-
Model selection: Select a model from the drop-down list. In most cases, the default selection is sufficient.
-
Model Studio API Key: Obtain an API key from Model Studio and enter it here. This key is required to call the model service.
Advanced settings
-
Environment variables: Add key-value pairs for any extra environment variables your application requires, such as business configurations. Leave blank if not needed. Collapsed by default.
Network configuration
-
Select the availability zone, virtual private cloud (VPC), vSwitch, CIDR block, and more as prompted on the page. You can create a new VPC or select an existing one.
Tool configuration
-
Application connection: Bind the agent to an existing Connection under your account. For example, to enable persistent sessions, you can bind a tool for session management. The list displays only connection types that are compatible with the current agent.
-
Model Studio MCP (if displayed): Marketplace agents are automatically associated with the required MCPs, and this information is read-only. You must ensure that the corresponding capabilities are enabled in Model Studio. If they are not enabled, follow the prompts to activate them. Otherwise, the agent may fail to use the MCPs.
After creation
After the deployment is complete, the page displays the following:
-
WebUI access URL: Open this URL in a browser to interact with the agent. The exact address and port are listed on the Overview tab or in the Outputs section. Port 5173 is commonly used.
-
API call example (if available): The page may provide a
curlexample for calling the conversation API, commonly on port 8090 at theprocesspath. The user utterance in the example is a placeholder. Replace it with your own content before making a call. -
Remote connection: Log on to the server by using tools like Workbench.
-
Initial password: Use this password to log on to the ECS instance.
FAQ
|
Symptom |
Troubleshooting |
|
You cannot start a conversation, or you see an authentication or key-related error. |
Verify that you have entered the Model Studio API Key and that the Model Studio service is enabled. |
|
An MCP-related error occurs. |
Verify that the Model Studio MCP is enabled. |
|
The session is not persistent, or the agent cannot connect to Redis. |
Verify that you have bound a session management connection in the Application connection settings. If you bind a connection to an existing agent, go to and publish again for the change to take effect. |
|
The WebUI fails to open. |
Check whether the deployment is complete. The initial startup can be slow; wait a few moments and try again. |