Skip to content

補足情報サイトに ch06 createModelFromEnv の差異記事を追加 #29

Description

@laiso

書籍の補足情報サイト (workspace/docs/index.html) に、第 6 章 createModelFromEnv の本書コードと配布リポジトリ実装の差異を説明する記事を追加してください。

修正対象ファイル

  • workspace/docs/index.html

追加内容

1. 章セクションの追加

第 4 章セクション (id="ch04-6-tools-demo-filename" を含む <section class=\"chapter-group\">) の 直後、第 7 章セクションの 直前 に、第 6 章セクションを新規追加してください。

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

  <article id=\"ch06-4-create-model-from-env\">
    <header>
      <span class=\"chapter-label\">6.4 節</span>
      <h3><code>createModelFromEnv</code> と配布リポジトリ実装の差異</h3>
      <a class=\"anchor\" href=\"#ch06-4-create-model-from-env\">#</a>
    </header>
    <dl>
      <dt>本書の記載</dt>
      <dd>
        <p>本書では <code>createModelFromEnv</code> を次の形で実装しています(抜粋)。</p>
        <pre><code>export function createModelFromEnv(): LanguageModel {
  const provider = process.env.LLM_PROVIDER;
  const modelName = process.env.LLM_MODEL;
  const apiKey = process.env.LLM_API_KEY;
  if (!provider) throw new Error('LLM_PROVIDER 環境変数が設定されていません');
  if (!modelName) throw new Error('LLM_MODEL 環境変数が設定されていません');
  switch (provider.toLowerCase()) {
    case 'openai': {
      if (apiKey &amp;&amp; !process.env.OPENAI_API_KEY) {
        process.env.OPENAI_API_KEY = apiKey;
      }
      const openai = createOpenAI();
      return openai(modelName);
    }
    // anthropic / google も同様に process.env 経由で apiKey を伝搬
  }
}</code></pre>
      </dd>
      <dt>症状</dt>
      <dd>
        <p>本書のコードをそのまま写経して進める範囲では問題なく動作します。ただし、配布リポジトリの <code>src/providers/modelFactory.ts</code> は付録 B(Responses API 対応)を含む拡張のため、次の 3 点で本書の記載と異なります。</p>
        <ul>
          <li><strong>シグネチャ</strong><code>createModelFromEnv(options?: { useResponses?: boolean })</code> のように Responses API の切替オプションを受け取ります。</li>
          <li><strong><code>LLM_API_KEY</code> の扱い</strong>:未設定時に明示的に <code>throw</code> します(本書版はサイレント通過のため、後段の SDK 呼び出しで <code>401</code> として現れます)。</li>
          <li><strong>API キーの渡し方</strong><code>createOpenAI({ apiKey })</code> のように直接引数で渡します(本書版は <code>process.env.&lt;PROVIDER&gt;_API_KEY</code> への代入経由)。</li>
        </ul>
        <p>このため、配布リポジトリの <code>bin/cli.ts --responses</code>(付録 B)を試そうとすると、本書版の <code>createModelFromEnv</code> には <code>useResponses</code> 切替が存在せず、付録 B のサンプルどおりに動作させられません。</p>
      </dd>
      <dt>対処</dt>
      <dd>
        <p>本書の章を順に進める読者は、本書のコードのままで問題ありません。配布リポジトリのコードを参照する場合や、付録 B(Responses API 対応)を試す場合は、リポジトリの <code>src/providers/modelFactory.ts</code> の実装を参照してください。</p>
        <p>Responses API 切替を本書版に最小限取り込みたい場合は、OpenAI ケースに次の分岐を加える方法があります。</p>
        <pre><code>case 'openai': {
  if (apiKey &amp;&amp; !process.env.OPENAI_API_KEY) {
    process.env.OPENAI_API_KEY = apiKey;
  }
  const useResponses = process.env.USE_RESPONSES_API === 'true';
  const openai = useResponses ? createOpenAIResponses() : createOpenAI();
  return openai(modelName);
}</code></pre>
      </dd>
      <dt>補足</dt>
      <dd>
        <p>同様の経緯で、本書 6.4 節のコード片では Google ケースの API キーに <code>process.env.GOOGLE_API_KEY</code> を使っていますが、配布リポジトリの <code>.env.example</code> および <code>src/providers/google.ts</code><code>GEMINI_API_KEY</code> を優先します(<code>GOOGLE_API_KEY</code> もフォールバックとして読みます)。本書のコードは引き続き動作しますが、リポジトリの環境変数名は <code>GEMINI_API_KEY</code> である点に留意してください。</p>
      </dd>
    </dl>
  </article>
</section>

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

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

第 4 章

` ブロック) の 直後、第 7 章ナビゲーション (`

第 7 章

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

```html

第 6 章

\`\`\`

注意事項

  • 既存記事 (ch03, ch04, ch07 系) の 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