メインコンテンツへスキップ
見出し画像

2-1 なぜ最初はブラウザ版なのか — API版との違いを知る前に

    はじめに:「どっちが優れているか」の話ではない

    DeepSeekを使い始めると、比較的早い段階で「API版」という言葉に出会います。

    「APIを使えば自動化できるらしい」

    「プログラミングから呼び出せるらしい」

    「ブラウザ版はおもちゃで、API版が本番らしい」

    そんな断片情報が頭の中で混ざり、「じゃあ最初からAPIを学んだほうが近道なのでは?」と考えてしまう。これは非常によくある誤解です。

    結論から言えば、順番が逆です。そして、この連載がブラウザ版から始まるのには、はっきりとした理由があります。


    ブラウザ版とAPI版は「同じモデルの別入口」ではない

    まず前提を整理しておきます。ブラウザ版とAPI版は、同じDeepSeekのモデルにアクセスするという点では共通しています。しかし、利用者に要求する能力がまったく異なります。

    画像

    ここで注目してほしいのは、学べることの列がまったく別物だという点です。

    API版を学んでも「問いの設計」は身につきません。逆に、ブラウザ版を学んでも「システムへの組み込み方」は身につきません。だからこそ、どちらを先に学ぶかで、その後の伸び方が変わるのです。


    理由1:ブラウザ版は「失敗がその場で見える」

    ブラウザ版の最大の利点は、対話の失敗が即座に可視化されることです。

    • プロンプトが曖昧で、思った答えが返ってこない

    • 文脈を渡し忘れて、頓珍漢な回答が来る

    • 深掘りしようとしたら、話が脱線する

    これらはすべて、その場で「あ、今のは自分の問い方が悪かった」と気づけます。そして、次の1往復で修正を試せます。

    API版では、この「気づき」のループが極端に遅くなります。コードを書き、実行し、ログを見て、原因を推測し、修正する。学習のテンポが10倍以上遅くなるのです。

    思考の訓練において、テンポは本質です。1日に100回失敗できる環境と、10回しか失敗できない環境では、成長速度がまったく違います。


    理由2:API版は「悪い習慣を高速で量産する」

    これは少し強い言い方ですが、本質を突いています。

    API版の本質は自動化です。自動化とは「同じ処理を大量に繰り返す」ことです。ここで恐ろしいのは、あなたが設計したプロンプトが、そのまま何百回、何千回と実行されるという点です。

    もしあなたがブラウザ版で「問いの設計」を学ばずにAPI版に進んだら、どうなるか。

    • 曖昧なプロンプトを自動実行し、曖昧な出力を大量に得る

    • 幻覚(ハルシネーション)を含む出力を、検証せずに流し続ける

    • 文脈設計のまずさが、そのままシステムの品質になる

    自動化は、良い設計を増幅し、悪い設計も同じだけ増幅します。
    ブラウザ版で1往復ずつ丁寧に学ぶことは、API版に進む前の「設計の練習」なのです。


    理由3:API版に進む前に身につけるべきことが、ブラウザ版に詰まっている

    この連載の第2章がブラウザ版に割かれているのは、ここがすべての土台だからです。
    ブラウザ版で身につけるべきは、具体的には次の3つです。

    ① 線引きの判断力

    何をAIに渡してよく、何を渡してはいけないか。これはAPI版でも同じ問いですが、ブラウザ版のほうが「自分の手で入力する」分、感覚が研ぎ澄まされます。

    ② 問いの設計力

    一度で完璧な答えを引き出そうとせず、対話を通じて問いを深める。この技術は、API版のプロンプト設計にそのまま活きます。

    ③ 出力を疑う力

    返ってきた答えを鵜呑みにせず、根拠を確認する。この習慣がなければ、API版での自動化は「誤情報の自動生成装置」になりかねません。

    これらはすべて、ブラウザ版の1往復ずつの対話でしか鍛えられません。


    「早くAPIに行きたい」という焦りについて

    正直に言えば、API版に早く進みたい気持ちは理解できます。自動化は魅力的ですし、「ブラウザでポチポチやるのは素人っぽい」という感覚もあるでしょう。

    しかし、ここで一つの問いを立ててみてください。

    「あなたは、何を自動化したいのか?」

    この問いに即答できないなら、まだAPI版に進む時期ではありません。自動化すべき「良い対話の型」が、まだあなたの中にないからです。

    逆に、ブラウザ版で何度も対話を重ね、「この問い方なら安定して良い出力が得られる」という型ができたとき、API版はその型を増幅する装置として意味を持ち始めます。


    第2章の位置づけ

    この第2章は、単なる「入門編」ではありません。API版に進むための準備章です。

    • 2-1(本記事):なぜブラウザ版から始めるのか

    • 2-2:ブラウザ対話で「入れてはいけない情報」の線引き

    • 2-3:ブラウザ版で身につけるべき判断力

    • 2-4:API版に進む前に、ここで何を学ぶか

    各節が、API版に進む前に回収すべき「宿題」になっています。逆に言えば、これらを飛ばしてAPI版に進むと、自動化のスピードだけが上がり、品質は上がらないという典型的な失敗に陥ります。


    まとめ:順番こそが最短距離

    • ブラウザ版とAPI版は、入口が違うだけでなく学べることが違う

    • ブラウザ版は「対話の設計」を、API版は「システムの設計」を学ぶ場

    • 対話の設計を学ばずに自動化すると、悪い習慣を高速で量産する

    • API版に進む前に、線引き・問いの設計・出力を疑う力の3つを身につける

    • 「何を自動化したいか」に即答できないなら、まだブラウザ版の出番


    次回:2-2 ブラウザ対話で「入れてはいけない情報」の線引き
    ブラウザ版で対話を始めると、最初にぶつかるのが「何を入力していいのか」という問いです。次回は、具体的な線引きの基準を整理します。


    ▼ この連載の元になった書籍
    『DeepSeek 対話の設計 ― ブラウザで試す、考える、深める』

    あなたへのおすすめ