通过SDK接入

Python

# Create and activate virtual environment
python3 -m venv agentbay-env
source agentbay-env/bin/activate  # Linux/macOS
# agentbay-env\Scripts\activate   # Windows

# Install the package
pip install wuying-agentbay-sdk

# Verify installation
python -c "import agentbay; print('Installation successful')"

# Install with user flag (if system allows)
pip install --user wuying-agentbay-sdk

# Verify installation 
python -c "import agentbay; print('Installation successful')"

TypeScript/JavaScript

# Initialize project (if new project)
mkdir my-agentbay-project && cd my-agentbay-project
npm init -y

# Install the package
npm install wuying-agentbay-sdk

# Verify installation
node -e "const {AgentBay} = require('wuying-agentbay-sdk'); console.log('Installation successful')"

Golang

# Initialize module (if new project)
mkdir my-agentbay-project && cd my-agentbay-project  
go mod init my-agentbay-project

# Install the package
GOPROXY=direct go get github.com/aliyun/wuying-agentbay-sdk/golang/pkg/agentbay

# Verify installation
go list -m github.com/aliyun/wuying-agentbay-sdk/golang && echo "Installation successful"

Python

import os
from agentbay import AgentBay

# Get API key from environment
api_key = os.getenv("AGENTBAY_API_KEY")
if not api_key:
    print("Please set AGENTBAY_API_KEY environment variable")
    exit(1)

try:
    # Initialize SDK
    agent_bay = AgentBay(api_key=api_key)
    print("SDK initialized successfully")
    
    # Create a session (requires valid API key and network)
    session_result = agent_bay.create()
    if session_result.success:
        session = session_result.session
        print(f"Session created: {session.session_id}")
        
        # Clean up
        agent_bay.delete(session)
        print("Test completed successfully")
    else:
        print(f"Session creation failed: {session_result.error_message}")
        
except Exception as e:
    print(f"Error: {e}")

TypeScript

import { AgentBay } from 'wuying-agentbay-sdk';

const apiKey = process.env.AGENTBAY_API_KEY;
if (!apiKey) {
    console.log("Please set AGENTBAY_API_KEY environment variable");
    process.exit(1);
}

async function test() {
    try {
        // Initialize SDK
        const agentBay = new AgentBay({ apiKey });
        console.log("SDK initialized successfully");
        
        // Create a session (requires valid API key and network)
        const sessionResult = await agentBay.create();
        if (sessionResult.success) {
            const session = sessionResult.session;
            console.log(`Session created: ${session.sessionId}`);
            
            // Clean up
            await agentBay.delete(session);
            console.log("Test completed successfully");
        } else {
            console.log(`Session creation failed: ${sessionResult.errorMessage}`);
        }
    } catch (error) {
        console.log(`Error: ${error}`);
    }
}

test();

Golang

package main

import (
    "fmt"
    "os"
    "github.com/aliyun/wuying-agentbay-sdk/golang/pkg/agentbay"
)

func main() {
    // Get API key from environment
    apiKey := os.Getenv("AGENTBAY_API_KEY")
    if apiKey == "" {
        fmt.Println("Please set AGENTBAY_API_KEY environment variable")
        return
    }

    // Initialize SDK
    client, err := agentbay.NewAgentBay(apiKey, nil)
    if err != nil {
        fmt.Printf("Failed to initialize SDK: %v\n", err)
        return
    }
    fmt.Println("Test completed successfully")

    // Create a session (requires valid API key and network)
    sessionResult, err := client.Create(nil)
    if err != nil {
        fmt.Printf("Session creation failed: %v\n", err)
        return
    }
    
    if sessionResult.Session != nil {
        fmt.Printf("Session created: %s\n", sessionResult.Session.SessionID)
        
        // Clean up
        _, err = client.Delete(sessionResult.Session, false)
        if err != nil {
            fmt.Printf("Session cleanup failed: %v\n", err)
        } else {
            fmt.Println("Test completed successfully")
        }
    }
}

Python问题

1. externally-managed-environment错误：

   # 解决方案：使用虚拟环境
   python3 -m venv agentbay-env
   source agentbay-env/bin/activate
   pip install wuying-agentbay-sdk

2. ModuleNotFoundError: No module named 'agentbay'：

   # 检查虚拟环境是否已激活
   which python  # Should show venv path
   # 如有需要重新安装
   pip install --force-reinstall wuying-agentbay-sdk

TypeScript 问题

1. Cannot find module 'wuying-agentbay-sdk'：

   # 确保目前位于包含 package.json 的项目目录中
   pwd
   ls package.json  # 验证package.json文件存在
   # 如有需要重新安装
   npm install wuying-agentbay-sdk

2. require() is not defined：

   # 验证 Node.js version (需要 14+)
   node --version
   # 确保正在使用 CommonJS（默认）或更新为 ES 模块

Golang 问题

1. checksum mismatch错误（最常见）：

   # 始终为此包使用直接代理
   GOPROXY=direct go get github.com/aliyun/wuying-agentbay-sdk/golang/pkg/agentbay

2. 导入路径错误：

   # 检查 Go version (需要 1.24.4+)
   go version
   # Ensure module is initialized
   go mod init your-project-name

3. 构建失败：

   # 清理模块缓存并重试
   go clean -modcache
   go mod tidy
   go get github.com/aliyun/wuying-agentbay-sdk/golang/pkg/agentbay

网络和 API 问题

1. 连接超时：

   • 检查网络连接。

   • 验证 API 网关端点是否适合您的位置。

   • 如果可以的话，尝试不同的网关端点以获得更好的连接。

2. API 密钥错误：

   • 验证 API 密钥是否正确且有效。

   • 在控制台中检查 API 密钥权限。

   • 确保环境变量设置正确。

3. 会话创建失败：

   • 验证账户是否有足够的配额。

   • 在控制台检查服务状态。

   • 过几分钟后再尝试。