LangChain CI インテグレーション

概要

LangChain アプリケーション向けの包括的な CI/CD パイプラインをテスト、リント、デプロイメント自動化で構成します。

前提条件

• Actions が有効な GitHub リポジトリ
• テストスイートを備えた LangChain アプリケーション
• テスト用の API キー (GitHub Secrets として保存)

手順

ステップ 1: GitHub Actions ワークフローを作成

# .github/workflows/langchain-ci.yml
name: LangChain CI

on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main]

env:
  PYTHON_VERSION: "3.11"

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: ${{ env.PYTHON_VERSION }}

      - name: Install dependencies
        run: |
          pip install ruff mypy

      - name: Lint with Ruff
        run: ruff check .

      - name: Type check with mypy
        run: mypy src/

  test-unit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: ${{ env.PYTHON_VERSION }}

      - name: Install dependencies
        run: |
          pip install -e ".[dev]"

      - name: Run unit tests
        run: |
          pytest tests/unit -v --cov=src --cov-report=xml

      - name: Upload coverage
        uses: codecov/codecov-action@v4
        with:
          files: coverage.xml

  test-integration:
    runs-on: ubuntu-latest
    needs: [lint, test-unit]
    # Only run on main branch or manual trigger
    if: github.ref == 'refs/heads/main' || github.event_name == 'workflow_dispatch'
    steps:
      - uses: actions/checkout@v4

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: ${{ env.PYTHON_VERSION }}

      - name: Install dependencies
        run: |
          pip install -e ".[dev]"

      - name: Run integration tests
        env:
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
        run: |
          pytest tests/integration -v -m integration

ステップ 2: テストマーカーを設定

# pyproject.toml
[tool.pytest.ini_options]
markers = [
    "unit: Unit tests (no external API calls)",
    "integration: Integration tests (requires API keys)",
    "slow: Slow tests (skip in fast mode)",
]
asyncio_mode = "auto"
testpaths = ["tests"]

ステップ 3: モックフィクスチャを作成

# tests/conftest.py
import pytest
from unittest.mock import MagicMock, AsyncMock
from langchain_core.messages import AIMessage

@pytest.fixture
def mock_llm():
    """Mock LLM for unit tests."""
    mock = MagicMock()
    mock.invoke.return_value = AIMessage(content="Mock response")
    mock.ainvoke = AsyncMock(return_value=AIMessage(content="Mock response"))
    return mock

@pytest.fixture
def mock_chain(mock_llm):
    """Mock chain for testing."""
    from langchain_core.prompts import ChatPromptTemplate
    from langchain_core.output_parsers import StrOutputParser

    prompt = ChatPromptTemplate.from_template("{input}")
    return prompt | mock_llm | StrOutputParser()

ステップ 4: Pre-commit フックを追加

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/astral-sh/ruff-pre-commit
    rev: v0.1.6
    hooks:
      - id: ruff
        args: [--fix]
      - id: ruff-format

  - repo: https://github.com/pre-commit/mirrors-mypy
    rev: v1.7.1
    hooks:
      - id: mypy
        additional_dependencies:
          - langchain-core
          - pydantic

ステップ 5: デプロイメントステージを追加

# .github/workflows/langchain-ci.yml に追加
  deploy:
    runs-on: ubuntu-latest
    needs: [test-integration]
    if: github.ref == 'refs/heads/main'
    environment: production
    steps:
      - uses: actions/checkout@v4

      - name: Deploy to Cloud Run
        uses: google-github-actions/deploy-cloudrun@v2
        with:
          service: langchain-api
          source: .
          env_vars: |
            LANGCHAIN_PROJECT=production

出力

• リント、テスト、デプロイステージを含む GitHub Actions ワークフロー
• マーカー付きの pytest 設定
• ユニットテスト用のモックフィクスチャ
• コード品質向上のための pre-commit フック

例

ローカルでテストを実行

# ユニットテストのみ実行（高速）
pytest tests/unit -v

# カバレッジ付きで実行
pytest tests/unit --cov=src --cov-report=html

# インテグレーションテストを実行（API キーが必要）
OPENAI_API_KEY=sk-... pytest tests/integration -v -m integration

# 遅いテストをスキップ
pytest tests/ -v -m "not slow"

インテグレーションテストの例

# tests/integration/test_chain.py
import pytest
from langchain_openai import ChatOpenAI
from langchain_core.prompts import ChatPromptTemplate

@pytest.mark.integration
def test_real_chain_invocation():
    """Test with real LLM (requires API key)."""
    llm = ChatOpenAI(model="gpt-4o-mini", temperature=0)
    prompt = ChatPromptTemplate.from_template("Say exactly: {word}")
    chain = prompt | llm

    result = chain.invoke({"word": "hello"})
    assert "hello" in result.content.lower()

エラーハンドリング

エラー	原因	解決策
Secret Not Found	GitHub シークレットが見つからない	リポジトリシークレットに OPENAI_API_KEY を追加
Rate Limit in CI	API 呼び出しが多すぎる	ユニットテストではモックを使用、インテグレーションテストを制限
Timeout	テストが遅い	タイムアウトマーカーを追加、テストを並列化
Import Error	開発依存関係がない	.[dev] エキストラが確実にインストールされているか確認

リソース

• GitHub Actions ドキュメント
• pytest ドキュメント
• Pre-commit

次のステップ

デプロイメント設定については、langchain-deploy-integration に進んでください。