Lindy アップグレード & マイグレーション

概要

Lindy SDK バージョンの安全なアップグレードと設定のマイグレーションガイドです。

前提条件

• 現在の SDK バージョンが特定されている
• 対象バージョンのチェンジログを確認済み
• 現在の設定のバックアップを取得済み
• テスト環境が利用可能である

手順

ステップ 1: 現在のバージョンを確認

# インストール済みのバージョンを確認
npm list @lindy-ai/sdk

# 利用可能な最新版を確認
npm view @lindy-ai/sdk version

# チェンジログを表示
npm view @lindy-ai/sdk changelog

ステップ 2: 破壊的変更を確認

// バージョン別の一般的な破壊的変更

// v1.x -> v2.x
// - クライアント初期化が変更
// 変更前: new Lindy(apiKey)
// 変更後:  new Lindy({ apiKey })

// - Agent.run() のシグネチャが変更
// 変更前: agent.run(input)
// 変更後:  lindy.agents.run(agentId, { input })

// - イベント名が変更
// 変更前: 'complete'
// 変更後:  'completed'

ステップ 3: 依存関係をアップデート

# 最新版にアップデート
npm install @lindy-ai/sdk@latest

# または特定バージョンをインストール
npm install @lindy-ai/sdk@2.0.0

# ピアの依存関係に関する警告を確認
npm ls @lindy-ai/sdk

ステップ 4: コードをアップデート

// v1 -> v2 マイグレーションスクリプト

// 旧コード (v1)
import Lindy from '@lindy-ai/sdk';
const client = new Lindy(process.env.LINDY_API_KEY);
const result = await client.runAgent('agt_123', 'Hello');

// 新コード (v2)
import { Lindy } from '@lindy-ai/sdk';
const client = new Lindy({ apiKey: process.env.LINDY_API_KEY });
const result = await client.agents.run('agt_123', { input: 'Hello' });

ステップ 5: マイグレーションテストを実行

// tests/migration.test.ts
import { Lindy } from '@lindy-ai/sdk';

describe('SDK マイグレーション', () => {
  const lindy = new Lindy({ apiKey: process.env.LINDY_API_KEY });

  test('クライアント初期化が機能する', async () => {
    const user = await lindy.users.me();
    expect(user.email).toBeDefined();
  });

  test('エージェント操作が機能する', async () => {
    const agents = await lindy.agents.list();
    expect(Array.isArray(agents)).toBe(true);
  });

  test('実行操作が機能する', async () => {
    const result = await lindy.agents.run('agt_test', {
      input: 'マイグレーションテスト',
    });
    expect(result.output).toBeDefined();
  });
});

マイグレーションチェックリスト

[ ] 現在の設定をバックアップ
[ ] 破壊的変更についてチェンジログを確認
[ ] package.json を更新
[ ] npm install を実行
[ ] import ステートメントを更新
[ ] クライアント初期化を更新
[ ] メソッド呼び出しを更新
[ ] テストスイートを実行
[ ] ステージング環境でテスト
[ ] 本番環境にデプロイ
[ ] 問題をモニタリング

出力

• SDK を対象バージョンにアップデート
• コードパターンをマイグレーション
• テストスイートがパス
• 変更内容を文書化

エラーハンドリング

問題	原因	解決策
インポートエラー	名前付きエクスポートが変更	新しいインポート構文を確認
型エラー	インターフェースが変更	TypeScript 型を更新
ランタイムエラー	メソッドシグネチャが変更	新しい API を確認

例

自動マイグレーションスクリプト

#!/bin/bash
# migrate-lindy.sh

echo "Lindy SDK マイグレーションを開始します..."

# バックアップ
cp package.json package.json.backup
cp -r src src.backup

# 更新
npm install @lindy-ai/sdk@latest

# テスト実行
npm test

if [ $? -eq 0 ]; then
  echo "マイグレーション成功!"
  rm -rf src.backup package.json.backup
else
  echo "マイグレーション失敗。ロールバック中..."
  mv package.json.backup package.json
  rm -rf src && mv src.backup src
  npm install
  exit 1
fi

リソース

• Lindy チェンジログ
• マイグレーションガイド
• SDK リファレンス

次のステップ

高度な機能については Pro ティアのスキルに進んでください。