AgentBay:SDK によるアクセス

Python

# 仮想環境の作成とアクティベート
python3 -m venv agentbay-env
source agentbay-env/bin/activate  # Linux/macOS
# agentbay-env\Scripts\activate   # Windows

# パッケージのインストール
pip install wuying-agentbay-sdk

# インストールの確認
python -c "import agentbay; print('Installation successful')"

# user フラグを付けてインストール (システムが許可する場合)
pip install --user wuying-agentbay-sdk

# インストールの確認
python -c "import agentbay; print('Installation successful')"

TypeScript/JavaScript

# プロジェクトの初期化 (新規プロジェクトの場合)
mkdir my-agentbay-project && cd my-agentbay-project
npm init -y

# パッケージのインストール
npm install wuying-agentbay-sdk

# インストールの確認
node -e "const {AgentBay} = require('wuying-agentbay-sdk'); console.log('Installation successful')"

Golang

# モジュールの初期化 (新規プロジェクトの場合)
mkdir my-agentbay-project && cd my-agentbay-project  
go mod init my-agentbay-project

# パッケージのインストール
GOPROXY=direct go get github.com/aliyun/wuying-agentbay-sdk/golang/pkg/agentbay

# インストールの確認
go list -m github.com/aliyun/wuying-agentbay-sdk/golang && echo "Installation successful"

Python

import os
from agentbay import AgentBay

# 環境から API キーを取得
api_key = os.getenv("AGENTBAY_API_KEY")
if not api_key:
    print("Please set AGENTBAY_API_KEY environment variable")
    exit(1)

try:
    # SDK の初期化
    agent_bay = AgentBay(api_key=api_key)
    print("SDK initialized successfully")
    
    # セッションの作成 (有効な API キーとネットワークが必要)
    session_result = agent_bay.create()
    if session_result.success:
        session = session_result.session
        print(f"Session created: {session.session_id}")
        
        # クリーンアップ
        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 {
        // SDK の初期化
        const agentBay = new AgentBay({ apiKey });
        console.log("SDK initialized successfully");
        
        // セッションの作成 (有効な API キーとネットワークが必要)
        const sessionResult = await agentBay.create();
        if (sessionResult.success) {
            const session = sessionResult.session;
            console.log(`Session created: ${session.sessionId}`);
            
            // クリーンアップ
            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() {
    // 環境から API キーを取得
    apiKey := os.Getenv("AGENTBAY_API_KEY")
    if apiKey == "" {
        fmt.Println("Please set AGENTBAY_API_KEY environment variable")
        return
    }

    // 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")

    // セッションの作成 (有効な API キーとネットワークが必要)
    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)
        
        // クリーンアップ
        _, 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  # venv のパスが表示されるはずです
   # 必要に応じて再インストールします
   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 のバージョンを確認します (14 以降が必要です)
   node --version
   # CommonJS (デフォルト) を使用しているか、ES モジュールに更新しているかを確認します

Golang の問題

1. checksum mismatch エラー (最も一般的)：

   # このパッケージには常に直接プロキシを使用します
   GOPROXY=direct go get github.com/aliyun/wuying-agentbay-sdk/golang/pkg/agentbay

2. インポートパスエラー：

   # Go のバージョンを確認します (1.24.4 以降が必要です)
   go version
   # モジュールが初期化されていることを確認します
   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. セッションの作成に失敗しました：

   • アカウントに十分なクォータがあることを確認してください。

   • コンソールでサービスのステータスを確認してください。

   • 数分後にもう一度試してください。