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

自分のAPIをChatGPTに繋ぐ。ActionsとOpenAPIスキーマ

    このシリーズのStep 4aです。Step 3の記事で、自分のポートフォリオAPIがインターネットから叩けるURL(https://〇〇.onrender.com/portfolio など)になっている前提です。シリーズの完成形は冒頭のフック記事で紹介しています。

    ChatGPT ではなく Claude.ai を使いたい方はStep 4b の記事にClaude.ai側の接続手順を書いています。

    自分のAPIのURLを持っていてOpenAPIスキーマも書き慣れている方は、この記事内の「GPT Builder Action 設定チェックリスト」セクションから読んでください。

    Step 4aでは、Step 3で作ったAPIのURLをChatGPTのGPT Builderに教えて、自分専用のCustom GPTを作ります。完成するとChatGPTのモバイルアプリから「今の維持率は?」と聞くだけで、あなたのAPIがJSONを返し、GPTがそれを読んで答えを返します。

    シリーズの最後は 4a(この記事、ChatGPT側)と 4b(Claude.ai側、無料)に分かれます。片方だけでも完結しますが、両方やっておくと手元にあるどちらのアプリからでも同じ問いを投げられる状態になります。

    ここまで通した後、GPT Builder との接続で「Action が呼ばれない」「スキーマと実レスポンスがズレる」「MCP レスポンスが token limit で切れる」といった接続段階のトラブルにぶつかる場面は、Zenn Book「自分のポートフォリオをAIに相談する — 動いた後の運用設計ガイド」の接続編エラー図鑑で扱っています。

    エージェントに丸投げする場合

    Step 1で入れたエージェントに次のように伝えます。

    依頼文

    「Step 3でデプロイしたAPI( https://〇〇.onrender.com/portfolio、実際のURLに置き換えて)のレスポンスを一度 curl で確認して、ChatGPT の GPT Builder の Actions に貼れる OpenAPI スキーマを書いて。認証は不要(誰でも読める前提)でいい。GPT Builder の設定手順もあわせて順に案内して、詰まったら聞くから対話しながら進めて」

    エージェントが curl で実レスポンスを確認し、それに合わせたスキーマを作ってくれます。GPT Builder のどこに何を貼るかも順番に案内してくれるので、そのまま従えば接続が完了します。

    ここから先は、スキーマの中身と設定内容を自分で確認しながら進めたい方向けの解説です。

    工程の全体像

    4工程です。一つ目、ChatGPT の GPT Builder を開き新しい GPT を作ります。二つ目、Configure タブの Actions セクションで OpenAPI スキーマを貼ります。三つ目、テスト実行で自分のAPIから正しくデータが返るか確認します。四つ目、保存して ChatGPT モバイルアプリから呼び出します。

    OpenAPI スキーマとは

    OpenAPI スキーマは「このAPIはどのURLにどういう形でリクエストして、どんなJSONが返ってくるか」を機械が読める形でまとめた設定ファイルです。GPT はこれを読んで、ユーザーが聞いた内容に応じて自分のAPIの適切なURLを叩きに行きます。

    最小のサンプル(Step 3で作った /portfolio を読む想定):

    openapi: 3.1.0
    info:
    title: My Portfolio API
    version: 1.0.0
    servers:
    - url: https://あなたのサービス名.onrender.com
    paths:
    /portfolio:
    get:
    operationId: getPortfolio
    summary: 現在のポートフォリオのスナップショットをJSONで返す
    responses:
    '200':
    description: 現在のポジション一覧

    「servers.url」は自分の Render のドメイン(末尾の /portfolio は含めない)に置き換えます。「paths」の下に自分のAPIが受け付けるパス(今回は /portfolio)を書きます。operationId はGPTが内部で使う識別子で、英数字で一意なら何でも構いません。summary はGPTが「このAPIは何をするか」を理解するための説明で、自分の言葉で書けばOKです。

    APIが複数のエンドポイント(/portfolio と /history など)を持つ場合は paths の下に並べて書きます。

    GPT Builder Action 設定チェックリスト

    1. https://chatgpt.com/gpts/editor を開く(ChatGPTのサイドバー「GPTs」→「Create」からも到達できる)。ChatGPT Plus以上のプランが必要
    2. 画面上部の「Configure」タブに切り替える(デフォルトは「Create」タブで対話しながら作る画面、「Configure」は項目を直接埋める画面)
    3. Nameに「My Portfolio」のような名前を入れる。Descriptionに「自分の資産状況を聞くためのGPT」など
    4. 一番下までスクロールして「Actions」セクションを見つけ「Create new action」をクリック
    5. 「Schema」欄に上記のOpenAPIスキーマを貼り付ける(自分のURLに置換済みで)
    6. Authentication は「None」を選ぶ(誰でも読める前提の場合)
    7. 画面下部の「Available actions」に getPortfolio が出ることを確認
    8. その右の「Test」ボタンを押して、実際に自分のAPIからJSONが返ることを確認する
    9. 画面上部に戻り「Instructions」欄にGPTの振る舞いを日本語で書く(例:「ユーザーに資産状況を聞かれたら getPortfolio を呼び出して、維持率・評価損益・気になるリスクを簡潔に要約する」)
    10. 画面右上の「Save」→「Only me」を選んで保存する(公開せず自分専用)

    ChatGPT モバイルアプリで使う

    ChatGPTのモバイルアプリ(iOS / Android)を開き、上部のモデル名の場所をタップすると「My GPTs」の一覧に保存したGPTが出ます。選んで「今の維持率は?」のように聞けば、作ったCustom GPTがあなたのAPIを叩いて答えを返します。

    動作確認

    「今のポートフォリオで気になる点は?」のような俯瞰的な問いを投げてみてください。GPTが /portfolio を叩き、返ってきたJSONを読んで要点を返せば完了です。エラーが出たり何も返さない場合は、GPT Builder の Configure タブに戻り Actions の「Test」で実レスポンスを確認して、スキーマが実際のレスポンス形に合っているか見直します。

    Step 4b へ

    これでChatGPTから自分のポートフォリオに繋がりました。Step 4b(無料)ではClaude.aiのコネクターで同じAPIに接続する手順を書きます。GPT だけで完結してもよいですが、Claude.ai も繋いでおくと好みのアプリでいつでも聞ける状態になります。

     
     
    全世界株+レバレッジドファンドを6年運用中。信用取引の実体験とリスクの数字を公開。資産データをAIに相談する仕組みも記録中。Zenn Book→zenn.dev/wireharbor

    あなたへのおすすめ