GitHub Copilot SDKをアプリに統合 – クイックガイド

はじめに

GitHub Copilot は単なる IDE プラグインではありません；それはコードを書いたりリファクタリングしたり、実際に実行したりすることができる AI エージェント です。公式 Copilot SDK は、そのエージェントをシンプルで言語に依存しない API の背後に隠し、ウェブ、デスクトップ、CLI、マイクロサービスなどあらゆるアプリケーションに組み込めるようにします。

Copilot SDKを使う理由？

• ブラウザを使わずに自社製品内で Copilot を実行できる。
• 自分の UI からコード生成をトリガーできる。
• Copilot を他サービスと組み合わせた複雑なツールチェーンを構築できる。
• Copilot CLI を通じてバイリングと使用量を一元管理できる。

対応言語とインストール

SDK は Python、Node.js/TypeScript、Go、.NET (C#) で利用可能です。インストールは言語ごとに1行です。

# Node.js / TypeScript
npm install @github/copilot-sdk

# Python
pip install github-copilot-sdk

# Go
go get github.com/github/copilot-sdk/go

# .NET
dotnet add package GitHub.Copilot.SDK

ヒント：SDK は Copilot CLI をバックグラウンドプロセスとしてバンドルしています。アクティブな GitHub Copilot サブスクリプション（無料 CLI ティアは利用可能ですが制限があります）が必要です。

基本例 – 「Hello World」エージェント

from github.copilot import Copilot

copilot = Copilot()

# Create a simple agent that writes a greeting
agent = copilot.agent(
    name="greeting-agent",
    description="Generate a friendly greeting in the target language.",
)

response = agent.run("create a greeting function that outputs 'Hello, world!' in Python.")
print(response.content)

python hello_agent.py を実行すると、完全装飾された def greet(): 関数が出力されます。

無限セッションの活用

v0.1.18 から SDK は 無限セッション をサポートし、複数プロンプトにわたって同じコンテキストを保持できます。エージェントを作成する際に infinite=True を渡して有効化します：

agent = copilot.agent(
    name="session-agent",
    infinite=True,
)

カスタムツールとスキル

自前のコマンドラインツールで Copilot を拡張できます。Skill を定義します：

import { Copilot, Skill } from "@github/copilot-sdk";

const skill = new Skill({
  name: "json‑pretty",
  command: "python -m json.tool",
  description: "Pretty‑prints JSON data.",
});

const copilot = new Copilot({
  tools: [skill],
});

セキュリティ & BYOK

SDK は転送中のデータ暗号化のための Bring‑Your‑Own‑Key (BYOK) をサポートしています。鍵は次のように設定します：

COPILOT_BK_SECRET=<your‑hex‑key>

よくある質問

• 有料サブスクリプションが必要ですか？ – はい、商用利用には有料が必要です。無料 CLI ティアは利用可能ですが、レート制限があります。
• 本番環境で使用できますか？ – SDK はTechnical Preview段階です。GA に先立ち小さな変更が予想されます。
• モデルの切替えは可能ですか？ – SDK は利用可能なモデルをリストアップするメソッドを公開しています。モデル名を agent.run に渡すことができます。

はじめに役立つリソース

• Copilot SDK GitHub ページ – フルドキュメントとサンプル。
• Copilot CLI Docs – インストール & 設定。
• SDK API Reference – 言語別ドキュメント。

結論

GitHub Copilot SDK は、AI ライティングフローが自社製品内で第一級の存在になる世界を開きます。数行でエージェントを起動し、カスタムスキルで調整し、コードの生成・リファクタリング・実行を開始できます。GitHub のセキュアな課金モデルを活用して、必要に応じて AI アシスタンスを解放します。

コーディングを楽しんでください！