Skip to content

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

@laiso

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 エスケープしてください (`<`, `>`, `&`)。
  • 既存記事の文体(です・ます調、`` 包み、`
    本書の記載
    ...
    ` 構造)を踏襲してください。

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