deploy-to-bailian.md

Deploy to Bailian

Bailian (Aliyun AgentStudio) manages agents with versioned updates and references official MCP servers by name rather than wiring vaults for them.

Provider configuration

providers:
  bailian:
    api_key: ${DASHSCOPE_API_KEY}
    workspace_id: ${BAILIAN_WORKSPACE_ID}
    # base_url is derived from workspace_id when omitted:
    # https://<workspace_id>.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio

Field	Required	Description
api_key	yes	DashScope API key (Bearer token). Resolve from .env with ${DASHSCOPE_API_KEY}.
workspace_id	yes	Bailian workspace id (llm-...). Resolve with ${BAILIAN_WORKSPACE_ID}.
base_url	no	Override the derived endpoint. When omitted it is derived from workspace_id.

Capabilities

Feature	Tier
Environment, Vault, Skill, Agent, MCP Server, Session	native
Memory Store	unsupported
Multi-Agent	unsupported
Deployment	emulated

• Skills upload as a zip via the Files API (two-step).
• MCP servers are official managed servers referenced by name (no vault needed for them).
• deployment run expands into a one-shot session; scheduling/outcome rubrics are not enforced server-side.

Minimal agent

version: "1"

providers:
  bailian:
    api_key: ${DASHSCOPE_API_KEY}
    workspace_id: ${BAILIAN_WORKSPACE_ID}

defaults:
  provider: bailian

environments:
  dev:
    config:
      type: cloud
      networking:
        type: unrestricted

agents:
  assistant:
    description: "General-purpose coding assistant"
    model: qwen3.7-max
    instructions: |
      You are a helpful coding assistant.
    environment: dev
    tools:
      builtin: [bash, read, glob, grep]

What Bailian uniquely supports

• Official skills — reference a platform-provided skill without uploading or managing its lifecycle. See examples/bailian/official-skill/.
• Official MCP servers — declare type: official and reference by name. See examples/bailian/with-mcp/.

Next steps

• Full Bailian config: examples/bailian/full/
• Runtime session script: examples/bailian/basic/run-session.ts