Quick start
AgentTeams lets you quickly build and manage AI Workers with unified access to multiple model providers. This topic guides you through activating the service, creating an instance, configuring a model, and validating your first AI Worker team.
Prerequisites
-
You have activated the AgentTeams service.
Step 1: Create a service-linked role
The first time you sign in to the AgentTeams console, you must authorize a service-linked role, which allows AgentTeams to access other cloud resources on your behalf.
-
Sign in to the AgentTeams console.
-
On your first visit, you are prompted to Grant Service-Linked Role. Click Authorize Now.
Step 2: Create an instance
-
Click Create Instance.
-
Enter an Instance Name, and select the Region, Virtual Private Cloud (VPC), vSwitch, and Network Access Type.
-
Click Create Now.
-
Click Activate Now.
-
Wait for the instance to initialize.
Step 3: Configure a model
-
In the navigation pane on the left of the instance details page, click Model Management.
-
Click Add Model, enter a Model Name, and select a Model Provider.
-
Click Create.
Troubleshooting
If debugging a Worker returns an error, check the model API key configuration in the following order:
-
Check the API key in the model configuration: An incorrect API key causes an
InvalidApiKeyerror when the model is called. In the navigation pane on the left of the instance details page, click Model Management, and confirm that the correct API key is entered for the model. -
Verify the API key in the Model Studio console: Go to the API key management page in the Alibaba Cloud Model Studio console and confirm that the API key is valid and can call the model.
-
Confirm that the model provider is Model Studio (DashScope): The Model Provider must be set to Model Studio (DashScope), and the corresponding API key must start with
sk-. -
Obtain a new API key: If the API key is invalid or lost, create a new one and update the model configuration. For instructions, see Obtain an API key.
Step 4: Create a user
-
In the navigation pane on the left of the instance details page, click User Management.
-
Click Create User.
-
Enter a Username, Display Name, and Email.
-
Select an Authentication Method.
-
Click Create Now.
Step 5: Create a Worker team
-
In the navigation pane on the left of the instance details page, click Worker Team.
-
Click Create Worker Team.
-
In the 1. Basic Information section, enter the Team Name, Team Admin, Team Members, and a Description.
-
In the 2. Team Leader Configuration section, select Custom Create.
-
Enter a Leader Name.
-
Select Model.
-
Enter the file content for SOUL.MD and AGENT.MD.
-
Configure Skill Binding and MCP Server Binding.
-
-
Click Create.
Step 6: Create a Worker
-
In the navigation pane on the left, click Worker Management.
-
Click Create Worker.
-
Select Custom Create.
-
Enter a Worker Name.
-
Select Model.
-
Select a Team.
-
Enter the file content for SOUL.MD and AGENT.MD.
-
Configure Skill Binding and MCP Server Binding.
-
-
Click Create Now.
Step 7: Validate the Worker team
-
In the navigation pane on the left, select Overview.
-
In the Instance Details section, turn on the Public Network Access switch.
-
Wait for the configuration to take effect.
-
In the Connection Point section, click Open next to Element UI to open the Element UI endpoint page.
-
Follow the on-screen instructions to sign in and validate the Worker team's features.
You have now created a AgentTeams instance, configured a model, and created your first Worker team.
Learn more
After you complete the basic setup, explore these features:
-
User Management: Invite collaborators to manage Worker and model resources.
-
Monitoring & Analytics: Use the dashboard to view Worker usage, model invocation counts, and resource consumption.
-
MCP service: Integrate external tools with your Workers to expand their capabilities.