Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions docs/copilot_cli_tutorial/appendix/references.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,13 @@ Check these sources before each workshop run. Copilot CLI changes quickly enough

| Date | Change | Source |
|------|--------|--------|
| 2026-07-24 | Claude Opus 5 now available in GitHub Copilot; CLI 1.0.75 adds native support — designed for complex, long-running coding tasks | [GitHub Blog Changelog](https://github.blog/changelog/2026-07-24-claude-opus-5-is-now-available-in-github-copilot) |
| 2026-07-21 | Gemini 3.6 Flash now available in GitHub Copilot | [GitHub Blog Changelog](https://github.blog/changelog/2026-07-21-gemini-3-6-flash-is-now-available-in-github-copilot) |
| 2026-07-09 | OpenAI GPT-5.6 Sol, Terra, and Luna now available in GitHub Copilot | [GitHub Blog Changelog](https://github.blog/changelog/2026-07-09-openai-s-gpt-5-6-sol-terra-and-luna-are-now-available-in-github-copilot) |
| 2026-07-02 | Copilot CLI can now authenticate in GitHub Actions using the built-in `GITHUB_TOKEN` with `permissions: copilot: write` — no PAT required | [GitHub Blog Changelog](https://github.blog/changelog/2026-07-02-copilot-cli-no-longer-needs-a-personal-access-token-in-github-actions) |
| 2026-07-02 | Gemini 2.5 Pro and Gemini 3 Flash scheduled for upcoming deprecation across Copilot surfaces | [GitHub Blog Changelog](https://github.blog/changelog/2026-07-02-upcoming-deprecation-of-gemini-2-5-pro-and-gemini-3-flash) |
| 2026-07-01 | Copilot CLI auto model selection now routes to the best model based on task type | [GitHub Blog Changelog](https://github.blog/changelog/2026-07-01-copilot-cli-auto-model-selection-routes-based-on-task) |
| 2026-07-01 | AI credit session limits can be set in Copilot CLI and SDK to cap per-session spend | [GitHub Blog Changelog](https://github.blog/changelog/2026-07-01-set-ai-credit-session-limits-in-copilot-cli-and-sdk) |
| 2026-06-29 | Claude Opus 4.8 (fast mode) entered preview across Copilot surfaces including Copilot CLI (admin policy off by default) | [GitHub Blog Changelog](https://github.blog/changelog/2026-06-29-claude-opus-4-8-fast-mode-is-now-in-preview-for-github-copilot) |
| 2026-06-26 | MAI-Code-1-Flash reached general availability for Copilot Business and Copilot Enterprise | [GitHub Blog Changelog](https://github.blog/changelog/2026-06-26-mai-code-1-flash-for-copilot-business-and-copilot-enterprise) |
| 2026-06-25 | Copilot code review now uses the CLI/SDK `grep`/`rg`/`glob`/`view` file tools (~20% lower review cost) and adds org-level default Medium analysis depth | [GitHub Blog Changelog](https://github.blog/changelog/2026-06-25-copilot-code-review-analysis-depth-and-efficiency-updates) |
Expand Down
7 changes: 6 additions & 1 deletion docs/copilot_cli_tutorial/features.ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,10 +24,15 @@
| ローカル/外部プロバイダー検証 | BYOK 設定を使う([BYOK](#byok) を参照) | モデルはツール呼び出しとストリーミングをサポートする必要がある |

!!! warning "モデルのライフサイクルは短い"
最近の changelog だけでも、GPT-4.1 は 2026-06-01 に deprecated、GPT-5.2 と GPT-5.2-Codex は 2026-06-05 に多くの Copilot 体験で deprecated、Opus 4.6 (fast) は 2026-06-29 に deprecated 予定です([GPT-4.1 deprecated](https://github.blog/changelog/2026-06-02-gpt-4-1-deprecated)、[GPT-5.2 and GPT-5.2-Codex deprecated](https://github.blog/changelog/2026-06-05-gpt-5-2-and-gpt-5-2-codex-deprecated)、[Upcoming deprecation of Opus 4.6 fast](https://github.blog/changelog/2026-06-18-upcoming-deprecation-of-opus-4-6-fast))。ワークショップ実施前に `/model`、[supported models](https://docs.github.com/copilot/reference/ai-models/supported-models)、[GitHub Blog Copilot changelog](https://github.blog/changelog/label/copilot/) を確認してください。
最近の changelog だけでも、GPT-4.1 は 2026-06-01 に deprecated、GPT-5.2 と GPT-5.2-Codex は 2026-06-05 に多くの Copilot 体験で deprecated、Opus 4.6 (fast) は 2026-06-29 に deprecated、Gemini 2.5 Pro と Gemini 3 Flash は近く deprecated 予定です([GPT-4.1 deprecated](https://github.blog/changelog/2026-06-02-gpt-4-1-deprecated)、[GPT-5.2 and GPT-5.2-Codex deprecated](https://github.blog/changelog/2026-06-05-gpt-5-2-and-gpt-5-2-codex-deprecated)、[Upcoming deprecation of Gemini 2.5 Pro and Gemini 3 Flash](https://github.blog/changelog/2026-07-02-upcoming-deprecation-of-gemini-2-5-pro-and-gemini-3-flash))。ワークショップ実施前に `/model`、[supported models](https://docs.github.com/copilot/reference/ai-models/supported-models)、[GitHub Blog Copilot changelog](https://github.blog/changelog/label/copilot/) を確認してください。
Comment on lines 26 to +27

固定の演習手順にしない範囲で、最近の追加として押さえるべき点は次のとおりです。

- **Claude Opus 5** が GitHub Copilot で利用可能になりました。慎重な推論と効果的なツール使用を必要とする複雑な長時間コーディングタスク向けで、CLI 1.0.75 でネイティブサポートされます([Claude Opus 5 available](https://github.blog/changelog/2026-07-24-claude-opus-5-is-now-available-in-github-copilot))。
- **Gemini 3.6 Flash** が GitHub Copilot で利用可能になりました([Gemini 3.6 Flash available](https://github.blog/changelog/2026-07-21-gemini-3-6-flash-is-now-available-in-github-copilot))。
- **GPT-5.6 Sol、Terra、Luna**(OpenAI)が GitHub Copilot で利用可能になりました([GPT-5.6 Sol, Terra, Luna available](https://github.blog/changelog/2026-07-09-openai-s-gpt-5-6-sol-terra-and-luna-are-now-available-in-github-copilot))。
- **Auto モデル選択** がタスクの種類に基づいて最適なモデルにルーティングするようになりました。ワークショップのスクリプトにモデル名を固定しないもう一つの理由です([Copilot CLI auto model selection routes based on task](https://github.blog/changelog/2026-07-01-copilot-cli-auto-model-selection-routes-based-on-task))。
- **AI クレジットのセッション制限** を CLI と SDK で設定し、エージェントがセッションで消費する量を上限設定できます。自律実行や CI に便利です([Set AI credit session limits](https://github.blog/changelog/2026-07-01-set-ai-credit-session-limits-in-copilot-cli-and-sdk))。
- Gemini 3.1 Pro (Preview) と Gemini 3.5 Flash は、プランとポリシーが許せば Copilot CLI で利用できます。Business/Enterprise 管理者はモデルポリシーで opt in する必要があります([Gemini models in Copilot CLI](https://github.blog/changelog/2026-06-02-gemini-models-in-copilot-cli-cloud-agent-and-the-copilot-app))。
- MAI-Code-1-Flash は Copilot Business および Copilot Enterprise で一般提供(GA)になりました(管理者はポリシーを有効化する必要があります)。Copilot CLI でもプランごとに段階的に提供されます([MAI-Code-1-Flash for Copilot Business and Copilot Enterprise](https://github.blog/changelog/2026-06-26-mai-code-1-flash-for-copilot-business-and-copilot-enterprise)、[MAI-Code-1-Flash available on more Copilot surfaces](https://github.blog/changelog/2026-06-18-mai-code-1-flash-available-on-more-copilot-surfaces))。
- Enterprise 管理者が構成した外部プロバイダーモデルは Copilot CLI の model picker に表示されます。一方で個人ユーザーはクライアント側 BYOK プロバイダーも構成できます([Copilot CLI supports enterprise BYOK models](https://github.blog/changelog/2026-06-17-copilot-cli-supports-enterprise-bring-your-own-key-byok-models))。
Expand Down
7 changes: 6 additions & 1 deletion docs/copilot_cli_tutorial/features.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,10 +24,15 @@ Use this decision table instead:
| Local or external-provider experiments | Use BYOK settings (see [BYOK](#byok)) | Model must support tool calling and streaming |

!!! warning "Model lifecycle changes quickly"
Recent changelog examples show why fixed model lists go stale: GPT-4.1 was deprecated on 2026-06-01, GPT-5.2 and GPT-5.2-Codex were deprecated across most Copilot experiences on 2026-06-05, and Opus 4.6 (fast) is scheduled for deprecation on 2026-06-29 ([GPT-4.1 deprecated](https://github.blog/changelog/2026-06-02-gpt-4-1-deprecated), [GPT-5.2 and GPT-5.2-Codex deprecated](https://github.blog/changelog/2026-06-05-gpt-5-2-and-gpt-5-2-codex-deprecated), [Upcoming deprecation of Opus 4.6 fast](https://github.blog/changelog/2026-06-18-upcoming-deprecation-of-opus-4-6-fast)). Before running a workshop, check `/model`, [supported models](https://docs.github.com/copilot/reference/ai-models/supported-models), and the [GitHub Blog Copilot changelog](https://github.blog/changelog/label/copilot/).
Recent changelog examples show why fixed model lists go stale: GPT-4.1 was deprecated on 2026-06-01, GPT-5.2 and GPT-5.2-Codex were deprecated across most Copilot experiences on 2026-06-05, Opus 4.6 (fast) was deprecated on 2026-06-29, and Gemini 2.5 Pro and Gemini 3 Flash are scheduled for deprecation ([GPT-4.1 deprecated](https://github.blog/changelog/2026-06-02-gpt-4-1-deprecated), [GPT-5.2 and GPT-5.2-Codex deprecated](https://github.blog/changelog/2026-06-05-gpt-5-2-and-gpt-5-2-codex-deprecated), [Upcoming deprecation of Gemini 2.5 Pro and Gemini 3 Flash](https://github.blog/changelog/2026-07-02-upcoming-deprecation-of-gemini-2-5-pro-and-gemini-3-flash)). Before running a workshop, check `/model`, [supported models](https://docs.github.com/copilot/reference/ai-models/supported-models), and the [GitHub Blog Copilot changelog](https://github.blog/changelog/label/copilot/).
Comment on lines 26 to +27

Recent additions worth knowing, without hard-coding them into exercises:

- **Claude Opus 5** is now available in GitHub Copilot, designed for complex, long-running coding tasks that require careful reasoning and effective tool use. CLI 1.0.75 adds native support ([Claude Opus 5 available](https://github.blog/changelog/2026-07-24-claude-opus-5-is-now-available-in-github-copilot)).
- **Gemini 3.6 Flash** is now available in GitHub Copilot ([Gemini 3.6 Flash available](https://github.blog/changelog/2026-07-21-gemini-3-6-flash-is-now-available-in-github-copilot)).
- **GPT-5.6 Sol, Terra, and Luna** (OpenAI) are now available in GitHub Copilot ([GPT-5.6 Sol, Terra, Luna available](https://github.blog/changelog/2026-07-09-openai-s-gpt-5-6-sol-terra-and-luna-are-now-available-in-github-copilot)).
- **Auto model selection** now routes to the best model for the task type rather than a single default — another reason not to fix a model name in workshop scripts ([Copilot CLI auto model selection routes based on task](https://github.blog/changelog/2026-07-01-copilot-cli-auto-model-selection-routes-based-on-task)).
- **AI credit session limits** can be set in the CLI and SDK to cap the amount an agent spends in a session — useful for autonomous runs and CI ([Set AI credit session limits](https://github.blog/changelog/2026-07-01-set-ai-credit-session-limits-in-copilot-cli-and-sdk)).
- Gemini 3.1 Pro (Preview) and Gemini 3.5 Flash are available on Copilot CLI when plan and policy allow them; Business/Enterprise admins must opt in via model policy ([Gemini models in Copilot CLI](https://github.blog/changelog/2026-06-02-gemini-models-in-copilot-cli-cloud-agent-and-the-copilot-app)).
- MAI-Code-1-Flash reached general availability for Copilot Business and Copilot Enterprise (admins must enable the policy); it is also available on Copilot CLI with staged availability by plan ([MAI-Code-1-Flash for Copilot Business and Copilot Enterprise](https://github.blog/changelog/2026-06-26-mai-code-1-flash-for-copilot-business-and-copilot-enterprise), [MAI-Code-1-Flash available on more Copilot surfaces](https://github.blog/changelog/2026-06-18-mai-code-1-flash-available-on-more-copilot-surfaces)).
- Enterprise-admin configured external-provider models now appear in the Copilot CLI model picker, while individual users can still configure client-side BYOK providers ([Copilot CLI supports enterprise BYOK models](https://github.blog/changelog/2026-06-17-copilot-cli-supports-enterprise-bring-your-own-key-byok-models)).
Expand Down
4 changes: 4 additions & 0 deletions docs/copilot_sdk_tutorial/appendix/references.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,6 +87,10 @@ Check these sources before each workshop run. The SDK and the Copilot CLI it dep

| Date | Change | Source |
|------|--------|--------|
| 2026-07-22 | SDK v1.0.8 (Python, Go, Java): per-agent reasoning effort — custom sub-agents can now have their own `reasoningEffort` level independent of the parent session | [Copilot SDK v1.0.8](https://github.com/github/copilot-sdk/releases/tag/v1.0.8) |
| 2026-07-22 | SDK v1.0.8 also adds AI credit session limits (from CLI 1.0.73) and stronger typing for `expAssignments` across SDKs | [Copilot SDK v1.0.8](https://github.com/github/copilot-sdk/releases/tag/v1.0.8) |
| 2026-07-16 | SDK v1.0.7 (Python, Go, Java): in-process (FFI) transport support for Python and Go SDK integrations; tool search configuration; opaque metadata passthrough on tool definitions; `canvasProvider` and managed settings support | [Copilot SDK v1.0.7](https://github.com/github/copilot-sdk/releases/tag/v1.0.7) |
| 2026-07-02 | Copilot CLI can now authenticate in GitHub Actions using the built-in `GITHUB_TOKEN` with `permissions: copilot: write` — no PAT required | [GitHub Blog Changelog](https://github.blog/changelog/2026-07-02-copilot-cli-no-longer-needs-a-personal-access-token-in-github-actions) |
| 2026-06-25 | SDK v1.0.4 (Python and Go): the Python package downloads the pinned CLI runtime instead of bundling it (`python -m copilot download-runtime`); adds an HTTP request callback to intercept inference requests, a `getBearerToken` callback for BYOK providers (e.g. Managed Identity), an experimental multi-provider BYOK registry, `preamble`/`preserve` system-message section controls, and `capi.enableWebSocketResponses` / `provider.transport` session options | [Copilot SDK v1.0.4](https://github.com/github/copilot-sdk/releases/tag/v1.0.4) |
| 2026-06-19 | Python and Go SDK tutorials established against the then-current SDK packages and Copilot CLI server mode | [github/copilot-sdk releases](https://github.com/github/copilot-sdk/releases) |
| 2026-06-18 | SDK v1.0.2: opt-in session memory on create/resume, tool `defer` option for tool search, `otlpProtocol` telemetry transport (`http/json` \| `http/protobuf`), `ModelBilling.tokenPrices`, and deterministic telemetry flush on client stop | [Copilot SDK v1.0.2](https://github.com/github/copilot-sdk/releases/tag/v1.0.2) |
Expand Down
13 changes: 8 additions & 5 deletions docs/copilot_sdk_tutorial/getting_started.ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -116,9 +116,10 @@ export COPILOT_GITHUB_TOKEN="github_pat_xxxxxxxxxxxxxxxxxxxx"

### 1. トークンを作成する

上記の「オプション C: Fine-grained PAT(CI 向け推奨)」に従います。
!!! note "2026-07-02: GitHub Actions では PAT が不要になりました"
[2026 年 7 月 2 日](https://github.blog/changelog/2026-07-02-copilot-cli-no-longer-needs-a-personal-access-token-in-github-actions)以降、Copilot CLI は GitHub Actions の組み込み `GITHUB_TOKEN` を使って認証できるようになりました。PAT の作成・管理が不要になります。ジョブ(またはワークフロー)に `permissions: copilot: write` を追加すれば、CLI が自動的にトークンを取得します。以下の PAT 方式も引き続き使えます。

> **なぜ `GITHUB_TOKEN` ではダメか?** Actions が自動提供する `secrets.GITHUB_TOKEN` では Copilot CLI を認証**できません**。**Copilot Requests** は*ユーザー所有*の fine-grained PAT でのみ付与できるためです。自分で PAT を作成し、Secret として保存する必要があります
上記の「オプション C: Fine-grained PAT(CI 向け推奨)」に従うか、**または**ワークフローに `permissions: copilot: write` を追加して組み込みの `GITHUB_TOKEN` を使います(上記の注を参照)

Comment on lines +122 to 123
### 2. 権限を選ぶ

Expand Down Expand Up @@ -159,17 +160,19 @@ export COPILOT_GITHUB_TOKEN="github_pat_xxxxxxxxxxxxxxxxxxxx"

---

## なぜ `GITHUB_TOKEN` `gh auth login` では動作しないのか
## `GITHUB_TOKEN` なしの `gh auth login` が動作しない理由

「静的な PAT を使わず、組み込みの `GITHUB_TOKEN`(やそれを使った `gh auth login`)で認証できないか?」というのはよくある疑問です。Copilot CLI/SDK では**これは動作しません**。しかもこれは設定ミスではなく、仕組み上の制約です。
> **更新(2026-07-02):** GitHub Actions に限っては、`permissions: copilot: write` を付与した組み込みの `GITHUB_TOKEN` で Copilot CLI を認証*できる*ようになりました([Copilot CLI no longer needs a PAT in GitHub Actions](https://github.blog/changelog/2026-07-02-copilot-cli-no-longer-needs-a-personal-access-token-in-github-actions))。下記の制約は古いトークン種別や GitHub Actions 以外の環境に適用されます。

「静的な PAT を使わず、Copilot アクセス権のないトークンを使った `gh auth login` で認証できないか?」というのはよくある疑問です。Copilot CLI/SDK では**これは動作しません**。設定ミスではなく、仕組み上の制約です。

- **`GITHUB_TOKEN` は GitHub App のインストールトークンです。** リポジトリ操作(contents・issues・pull requests)にスコープされており、**ユーザーアカウントに紐づきません**。そのため **Copilot Requests** が表す Copilot のエンタイトルメントを持つことができません。
- **`GITHUB_TOKEN` を使った `gh auth login` でも解決しません。** これは GitHub REST/GraphQL **API** の認証であって、Copilot サブスクリプションの認証ではありません。トークンの背後に課金対象となるユーザー ID が存在しないためです。
- **トークンは読み込まれた上で拒否されます。** Copilot CLI は `COPILOT_GITHUB_TOKEN` → `GH_TOKEN` → `GITHUB_TOKEN` の順で認証情報を解決します。`GITHUB_TOKEN` を渡すと CLI は*読み込み*ますが、バックエンドが「Copilot へのアクセス権がない」としてリクエストを拒否します。

### 「静的なトークンを使いたくない」場合

気持ちは分かりますが、Copilot CLI/SDK では**ユーザー所有の fine-grained PAT が現時点で唯一サポートされる CI 認証情報**です。静的トークンを完全に排除することはできないため、代わりに影響範囲を最小化します。
**GitHub Actions の場合**、`permissions: copilot: write` を追加することで組み込みの `GITHUB_TOKEN` を使えます(静的 PAT 不要)([Copilot CLI no longer needs a PAT in GitHub Actions](https://github.blog/changelog/2026-07-02-copilot-cli-no-longer-needs-a-personal-access-token-in-github-actions))。他の CI 環境では、ユーザー所有の fine-grained PAT が引き続きサポートされる認証情報です。影響範囲を最小化するために:

- `Copilot Requests` **のみ**を付与する(Repository 権限の追加は最小限に)。
- トークンの対象を **Only select repositories** に絞る。
Expand Down
Loading