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

03 JSONレスポンスとパラメータを読む Cat Facts API 編

(シリーズ全編を読む場合は、マガジンで購入がお得です)

今回の目標

  • JSON形式のレスポンス を読む感覚をつかむ

  • GPTs(Custom GPT) に ユーザーの指定に応じて件数を変える 例を作る

  • パラメータとレスポンス構造を一緒に読む練習をする

ここから先では、Cat Facts API を使って「API が返す JSON のどこを読めばよいか」を手順化します。
YAML をただ貼るだけでなく、返ってきたデータの構造を見ながら Action を調整する感覚をつかむ回です。


こんな GPTs(Custom GPT) を作ります

  • ユーザー: `ランダムな猫の事実を教えて`

  • GPT: `Cats sleep for 70% of their lives.`

  • ユーザー: `5個ください`

  • GPT: `5件分の猫情報を JSON で取得して、日本語でまとめて返す`


Cat Facts API 概要


JSON をざっくり理解する

JSON は、テキストでデータ構造を表すための書き方です。
もともとは JavaScript 向けに広まった形式ですが、今では API のデータ受け渡しで非常によく使われます。

便利なのは、項目名と値をセットで送れる ことです。
たとえば `fact` という項目に猫の豆知識を入れたり、`data` という項目の中に複数件の配列を入れたりできます。

{
  "data": [
    {
      "fact": "Cats sleep for 70% of their lives."
    }
  ]
}

今回の Cat Facts API でも、ただの文章だけが返るのではなく、こうした構造化された JSON が返ってきます。
そのため、どの項目に何が入っているかを見ながら YAML を書く必要があります。

YAML との違いも軽く押さえておくと分かりやすいです。

  • JSON は波かっこ `{}` や角かっこ `[]` を使って構造を表す

  • YAML はインデントで構造を表す

  • JSON はインデントなしの 1 行でも書けるが、人間には読みにくくなりやすい

  • YAML は人間には読みやすいが、インデントが崩れると壊れやすい

つまり、JSON はデータ交換向き、YAML は設定を書くときに読みやすい と考えると、最初は整理しやすいです。


必要な構成要素

  • GPTs(Custom GPT)

  • JSON形式のレスポンスを返すアクション(Actions)

  • ユーザー入力に応じた `limit` 値の制御(例:猫の事実数)


 
 
非IT系の立場から、生成AIを実際に使ってみて感じたこと・つまずいた点・誤解されやすい挙動などを記録しています。ChatGPTやGPTsを中心に、試行錯誤の過程も含めてまとめています。NoaRecord運営。

あなたへのおすすめ