AgentBay：通過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 Gateway端點是否適合您的位置。

   • 如果可以的話，嘗試不同的網關端點以獲得更好的串連。

2. API 金鑰錯誤：

   • 驗證 API 金鑰是否正確且有效。

   • 在控制台中檢查 API 金鑰許可權。

   • 確保環境變數設定正確。

3. 會話建立失敗：

   • 驗證賬戶是否有足夠的配額。

   • 在控制台檢查服務狀態。

   • 過幾分鐘後再嘗試。