Skip to content

補足情報サイトに ch02 環境変数名 (GEMINI/GOOGLE) の差異記事を追加 #36

Description

@laiso

書籍の補足情報サイト (workspace/docs/index.html) に、Google 系 API キーの環境変数名の差異を説明する補足記事を追加してください。

修正対象ファイル

  • workspace/docs/index.html のみ(バックアップファイル *.backup は作成しないでください)

追加内容

1. 第 2 章セクションを新規追加

第 3 章セクション(<article id=\"ch03-3-llm-api-error\"> を含む <section class=\"chapter-group\">)の 直前 に、第 2 章セクションを新規追加してください(既存の第 3 章セクションは一切変更・削除しないでください)。

<section class=\"chapter-group\">
  <h2>第 2 章</h2>

  <article id=\"ch02-7-env-key-name\">
    <header>
      <span class=\"chapter-label\">2.7 節</span>
      <h3>Google 系 API キーの環境変数名</h3>
      <a class=\"anchor\" href=\"#ch02-7-env-key-name\">#</a>
    </header>
    <dl>
      <dt>本書の記載</dt>
      <dd>
        <p>本書 2.7 節「API キーの設定」の <code>.env</code> 記載例では、Google の API キーを次のように記載しています。</p>
        <pre><code>OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GOOGLE_API_KEY=AI...</code></pre>
        <p>同様に第 6 章の <code>createModelFromEnv</code> のコード例でも <code>process.env.GOOGLE_API_KEY</code> が使われています。一方、第 3 章のプロバイダー実装と表では <code>GEMINI_API_KEY</code> が登場しており、本書内で表記が混在しています。</p>
      </dd>
      <dt>症状</dt>
      <dd>
        <p>配布リポジトリの <code>.env.example</code><code>GEMINI_API_KEY</code> を採用しています。このため、配布リポジトリ実体に合わせて <code>.env</code> を作成する場合と、本書 2.7 節の例どおりに作成した場合で、環境変数名が異なる状態になります。</p>
      </dd>
      <dt>対処</dt>
      <dd>
        <p>配布リポジトリの <code>src/providers/google.ts</code><code>GEMINI_API_KEY</code> を優先しつつ <code>GOOGLE_API_KEY</code> もフォールバックとして参照する実装になっているため、どちらの環境変数名を設定しても動作します。配布リポジトリと一致させたい場合は <code>GEMINI_API_KEY</code> を使用してください。</p>
        <pre><code>const apiKey =
    config.apiKey ?? process.env.GEMINI_API_KEY ?? process.env.GOOGLE_API_KEY;</code></pre>
      </dd>
    </dl>
  </article>
</section>

2. ナビゲーションへの追加

`<aside class="toc">` 内、第 3 章ナビゲーション(`

第 3 章

` ブロック)の 直前 に、第 2 章ナビゲーションを追加してください。

```html

第 2 章

\`\`\`

編集時の禁止事項

editFile を使う際は必ず以下を守ってください。

  1. `oldText` は最小範囲(変更箇所の数行のみ)にしてください。既存の `
    ` `
    ` `` `` 等の保持されるべきタグを `oldText` に含めないでください。
  2. 既存の第 3 章, 第 4 章, 第 6 章, 第 7 章, 第 8 章セクションは一切変更・削除しないでください。新規 article を「挿入」するだけです。
  3. バックアップファイル(`*.backup` 等)を作成しないでください。万が一作成した場合も `git add` しないでください。

その他注意事項

  • 既存記事 (ch03, ch04, ch06, ch07, ch08 系) の HTML 構造・class 名 (`chapter-group`, `chapter-label`, `anchor` など) と一致させてください。
  • `
    ` 内の `<` / `>` / `&` は HTML エスケープしてください (`<`, `>`, `&`)。
  • 既存記事の文体(です・ます調、`` 包み、`
    本書の記載
    ...
    ` 構造)を踏襲してください。

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions