🏫3時限目「関数・引数・return・関数の呼び出し・型ヒントとは？」【🍞sales_data_appで学ぶPython基礎】

はじめに

📢 2026年9月7日追記

sales_data_app のGuest Demoを公開しました。

現在は、記事内で紹介しているAIアドバイス機能も実際に操作しながら、今回学ぶPythonの基礎がどこで使われているのか確認できます。

https://bakery-salesdata.onrender.com/

普段は物流トラックドライバーをしながらPython学習をしている tosane932 です。

僕がPython学習を始めた初期から現在進行形で開発を続けている、

🍞 sales_data_app 🥖

の実際のコードを教材に、Python基礎を学び直しています。

1時限目では、

変数・データ型・比較演算子・if文

を学び直しました。

2時限目では、

リスト・辞書・set・for文

を学び直しました。

2時限目では、複数の商品データを、

listでまとめる
        ↓
for文で1件ずつ処理する
        ↓
setとif文で商品IDを確認する
        ↓
dictで1件の商品情報をまとめる

という流れで見ていきました。

今回はさらに一歩進んで、

いくつかの処理をまとめて、必要なときに使えるようにするにはどうするのか？

を見ていきます。

---

📚️ 今回の記事を3行でまとめると

• defを使って関数を作り、処理をひとまとめにする仕組みを確認する
• 引数として値を受け取り、returnで結果を返し、別の場所から関数を呼び出す流れを追う
• 実コードの: strや-> strから、型ヒントが何を表しているのかを学び直す

---

🐹 今回もモグラくんと学び直します

🐹「1時限目ではif文、2時限目ではfor文……少しずつコードが長くなってきたね。」

たしかに。

例えば、

売上データを受け取る
↓
内容をまとめる
↓
AIに渡す文章を作る
↓
AIへ送信する
↓
結果を返す

というように、アプリの処理が増えてくると、

全部をひと続きに書いていくとコードもどんどん長くなっていきます。

🐹「同じような処理を、必要になるたびに全部書くのも大変そうだなぁ……。」

そこで登場するのが、

関数

です。

---

🍞 それでは3時限目

今回のテーマ

「関数・引数・return・関数の呼び出し・型ヒントとは？」

今回学び直すのは5つです。

📚 今回学ぶ5つ

1. 関数：処理をひとまとめにする
2. 引数：関数へ値を渡す
3. return：関数から結果を返す
4. 関数の呼び出し：作った関数を実際に使う
5. 型ヒント：受け取る値や返す値の型を読み手に伝える

今回は、

関数を作る
↓
値を受け取る
↓
処理する
↓
結果を返す
↓
別の場所から呼び出す

という一連の流れとして見ていきます。

---

1. 📦 関数とは？

まずは関数です。

Pythonでは、

def

を使って関数を定義できます。

簡単な例なら、

def say_hello():
    print("こんにちは")

のように書けます。

ここでは、

def
↓
これから関数を作る

say_hello
↓
関数の名前

()
↓
引数を書く場所

:
↓
ここから関数の処理

という形になっています。

この関数を作っただけでは、まだ、

こんにちは

とは表示されません。

関数は、

必要なときに呼び出して使えるよう、処理をひとまとめにしたもの

と考えると分かりやすそうです。

🐹「処理を箱に入れて、名前を付けておく感じ？」

今回はそのイメージで進めてみます。

---

🍞 sales_data_appの関数を見てみる

実際の sales_data_app には、

prompts.py

というファイルがあります。

その中に、次の関数があります。

def build_sales_prompt(sales_summary: str) -> str:
    return f"""
    ...
    {sales_summary}
    ...
    """

※実際のプロンプト本文は長いため、今回見る部分を中心に省略しています。

関数名は、

build_sales_prompt

です。

英語をそのまま読むと、

build
↓
作る

sales_prompt
↓
売上のプロンプト

なので、

売上データからAIへ渡すプロンプトを作る関数

という役割が名前からも見えてきます。

---

🐹「あ、関数名を見るだけでも何をするコードなのか少し分かるね。」

実際のコードでも、この関数は売上データを受け取り、AIへ渡す文章を作る役割を持っています。

---

図1：sales_data_appでは、売上データをもとにAIアドバイスを生成します。その裏側で、AIへ渡す文章を作る関数が使われています。

---

2. 📥 引数とは？

次は引数です。

例えば、

def greet(name):
    print(name)

という関数があるとします。

ここには、

name

という値を受け取る場所があります。

そして、

greet("モグラくん")

と呼び出せば、

モグラくん

という値を関数へ渡すことができます。

イメージすると、

"モグラくん"

      ↓

greet("モグラくん")

      ↓

name

です。

---

sales_data_appでは何を受け取っている？

もう一度、実際のコードを見てみます。

def build_sales_prompt(sales_summary: str) -> str:

この、

sales_summary

が、関数が受け取る値です。

sales_summary には、売上データをまとめた文字列が渡されます。

実際の app.py では、

sales_summary = ", ".join(
    [f"{name}: {qty}個" for name, qty in ranked_sales]
)

図2：売上数量ランキングには、商品ごとの販売数が並んでいます。これらの売上データをまとめてsales_summaryを作ります。

として売上データをまとめ、そのあと、

prompt = build_sales_prompt(sales_summary)

としています。

ここで、

sales_summary

を、

build_sales_prompt()

へ渡しています。

売上データ

        ↓

sales_summary

        ↓

build_sales_prompt(sales_summary)

        ↓

関数の中へ渡される

🐹「関数って、ただ処理するだけじゃなくて、外から材料を渡せるのか。」

まさに今回のコードでは、

売上データが材料

になっています。

---

💡 「引数」という言葉について

関数を定義するときの、

def greet(name):

の name は、より細かく言うと仮引数と呼ばれます。

一方、

greet("モグラくん")

で渡している "モグラくん" は実引数です。

今回はまず、

関数が受け取る場所
↓
name

実際に渡す値
↓
"モグラくん"

という違いを見ておきます。

---

3. 📤 returnとは？

関数へ値を渡したら、

今度は関数から結果を返すこともできます。

そこで登場するのが、

return

です。

例えば、

def add(a, b):
    return a + b

なら、

add(2, 3)

の結果として、

5

を返します。

2と3を渡す
↓
関数の中で足す
↓
return
↓
5を返す

という流れです。

---

🍞 sales_data_appのreturn

build_sales_prompt() では、

def build_sales_prompt(sales_summary: str) -> str:
    return f"""
    ...
    {sales_summary}
    ...
    """

となっています。

ここでは、受け取った、

sales_summary

をプロンプトの文章へ組み込み、

完成した文字列を、

return

で返しています。

sales_summaryを受け取る
        ↓
AIへ送る文章を作る
        ↓
return
        ↓
完成した文章を返す

🐹「入口からデータを受け取って、出口から結果を返すのか！」

関数の流れが少し見えてきました。

---

🔁 ここで1時限目のif文がまた登場

return は、関数の最後だけに出てくるとは限りません。

実際の sales_data_app には、

def _generate_ai_advice(ranked_sales, current_dataset=None):
    if not ranked_sales:
        return "売上データがまだないため、アドバイスを生成できません。"

という処理があります。

ここでは、

if not ranked_sales:

によって、

売上データがない場合

を確認しています。

条件が成立したら、

return "売上データがまだないため、アドバイスを生成できません。"

として、その場で結果を返します。

関数が呼ばれる
↓
売上データはある？
↓
ない
↓
if文の条件が成立
↓
return
↓
メッセージを返す

🐹「またif文だ！」

1時限目で学んだif文が、3時限目でも普通に出てきました。

---

💡 returnには「関数を終える」役割もある

return が実行されると、

その関数の処理はそこで終了します。

今回のコードでは売上データがなければ、

return "売上データがまだないため、アドバイスを生成できません。"

によって結果を返し、その先のAI生成処理へ進みません。

return は、

結果を返す
+
その関数の処理を終了する

という役割を持っています。

---

4. ☎️ 関数の呼び出しとは？

関数は、

作っただけでは動きません。

実際に使うには、その関数を呼び出す必要があります。

例えば、

def say_hello():
    print("こんにちは")

という関数なら、

say_hello()

と書くことで呼び出せます。

---

🍞 sales_data_appではどう呼び出している？

実際のコードでは、

prompt = build_sales_prompt(sales_summary)

としています。

ここでは、

build_sales_prompt(sales_summary)

によって関数を呼び出しています。

そして、その左側には、

prompt =

があります。

つまり、

sales_summaryを渡す

        ↓

build_sales_prompt(sales_summary)

        ↓

関数の中でプロンプトを作る

        ↓

return

        ↓

完成した文字列が戻ってくる

        ↓

promptに入る

という流れです。

🐹「おお……関数の入口と出口がつながった！」

---

変数・関数・returnもつながっていた

ここで1時限目の変数も出てきています。

prompt = build_sales_prompt(sales_summary)

右側では、

build_sales_prompt(sales_summary)

を実行しています。

そして関数から返ってきた結果を、

prompt

という変数へ入れています。

つまり、

関数を呼び出す
↓
returnで値が返る
↓
変数に入れる

です。

1時限目で学んだ、

month = 9

とは右側が少し複雑になっていますが、

右側の結果を
左側の変数へ入れる

という基本は同じです。

---

🐹「1時限目の変数まで帰ってきたぞ。」

こうして見ると、以前学んだ基礎が少しずつつながってきます。

---

5. 🏷️ 型ヒントとは？

最後は型ヒントです。

今回の実コードには、

def build_sales_prompt(sales_summary: str) -> str:

と書かれています。

🐹「さっきから気になってたんだけど……この: strと-> strは何？」

ここを分解してみます。

---

sales_summary: str

まず、

sales_summary: str

です。

これは、

sales_summary
↓
引数の名前

str
↓
文字列を想定している

という型ヒントです。

1時限目で、

str

は文字列の型だと確認しました。

つまり、

sales_summary: str

は、

sales_summaryには文字列を受け取る想定ですよ

という情報をコード上に書いています。

---

-> str

次は、

-> str

です。

これは、

この関数はstr型の値を返す想定ですよ

という型ヒントです。

今回の関数では、

return f"""
...
"""

として文字列を返しています。

なので、

sales_summary: str
↓
文字列を受け取る想定

-> str
↓
文字列を返す想定

となっています。

---

def build_sales_prompt(sales_summary: str) -> str:

を、今回学んだ内容だけで読むと、

def
↓
関数を作る


build_sales_prompt
↓
関数の名前


sales_summary
↓
受け取る値


: str
↓
文字列を受け取る想定


-> str
↓
文字列を返す想定

になります。

🐹「最初は暗号みたいだった1行が、だいぶ読めるようになった！」

---

⚠️ 型ヒント＝自動的な型チェックではない

名前の通り、これは型のヒントです。

sales_summary: str

と書いたからといって、それだけでPythonが必ず、

str以外は絶対に受け付けません！

と自動的に止めてくれるわけではありません。

今回はまず、

「この関数は、どんな型の値を受け取り、どんな型を返す想定なのか読みやすくする情報」

として理解しておきます。

---

🔗 5つを全部つなげてみる

ここまで学んだ5つを、実際の処理としてつなげてみます。

def build_sales_prompt(sales_summary: str) -> str:
    return f"""
    ...
    {sales_summary}
    ...
    """

そして別の場所から、

prompt = build_sales_prompt(sales_summary)

と呼び出します。

流れにすると、

def
↓
関数を作る

        ↓

sales_summary: str
↓
文字列を受け取る

        ↓

関数の中で
AIへ渡す文章を作る

        ↓

return
↓
完成した文字列を返す

        ↓

build_sales_prompt(sales_summary)
↓
別の場所から関数を呼び出す

        ↓

prompt =
↓
返ってきた値を変数へ入れる

という流れです。

そして、

-> str

を見ることで、

この関数は文字列を返す想定なんだな

ということも読み取れます。

---

🐹「関数・引数・return・呼び出し・型ヒント……。」

🐹「5個別々に覚えるんじゃなくて、全部1本の流れだったんだね。」

今回も、実コードを分解したことでつながって見えてきました。

---

🤖 AIアドバイス生成の流れから考える

sales_data_app の処理を今回の範囲で簡単にすると、

売上データがある

        ↓

sales_summaryにまとめる

        ↓

build_sales_prompt(sales_summary)
を呼び出す

        ↓

売上データを受け取る

        ↓

AIへ渡すプロンプトを作る

        ↓

returnでプロンプトを返す

        ↓

promptへ入れる

        ↓

Geminiへ送信する

        ↓

AIの回答を受け取る

図3：sales_summaryを組み込んだプロンプトをもとに生成されたAIアドバイスの前半です。

図4：図3と同じAIアドバイスの続きです。AIから返された結果が画面に表示されています。

となります。

画面上では、

「AIアドバイスが表示される」

という一つの機能に見えます。

でもコードの中を見ると、

変数
関数
引数
return
関数の呼び出し
型ヒント

と、Pythonの基礎が組み合わさっています。

---

🔁 さらにreturnがもう一度

AIから回答を受け取ったあとにも、

実際のコードでは、

return response.text

があります。

つまり、

AIへリクエストする
↓
AIからresponseを受け取る
↓
response.textをreturnする

という流れです。

return は、

build_sales_prompt()

だけに使われているわけではありません。

別の関数でも、

処理した結果を呼び出し元へ返す

ために使われています。

🐹「同じreturnでも、返しているものが違うんだ。」

これも、1回見ただけではなく別の実コードでも確認することで、少しずつ理解が深まりそうです。

---

🚀 Guest Demoを公開しました

sales_data_app のGuest Demoを公開しました。

現在はログイン画面から 「ゲストデモを体験する」 を選ぶことで、アカウント登録なしで実際の画面を操作できます。

https://bakery-salesdata.onrender.com/

今回の記事で見てきたPythonの基礎も、Guest DemoのAIアドバイス機能の裏側で実際に使われています。

売上データがあると、Python側ではまず商品ごとの販売数をまとめて、

sales_summary = ", ".join(
    [f"{name}: {qty}個" for name, qty in ranked_sales]
)

という文字列を作ります。

その値を、

prompt = build_sales_prompt(sales_summary)

として build_sales_prompt() へ渡します。

関数側では、

def build_sales_prompt(sales_summary: str) -> str:
    return f"""
    ...
    {sales_summary}
    ...
    """

のように値を受け取り、AIへ渡すプロンプトを作って return します。

Guest Demoで売上データを見る
        ↓
sales_summaryを作る
        ↓
build_sales_prompt(sales_summary)
を呼び出す
        ↓
sales_summaryを引数として受け取る
        ↓
AIへ渡す文章を作る
        ↓
returnで文字列を返す
        ↓
promptへ代入する
        ↓
Geminiへ送信する
        ↓
AIアドバイスが画面に表示される

つまり今回学んだ、

関数
引数
return
関数の呼び出し
型ヒント

も、練習用のサンプルコードだけではなく、実際に操作できるWebアプリのAIアドバイス生成処理で使われています。

記事を読みながらGuest DemoのAIアドバイス機能も見てみると、

「画面にAIの回答が表示されるまでに、関数へ値を渡して、結果を受け取りながら処理がつながっているんだ」

と、画面とコードを結びつけながら確認できます🐹

---

📝 3時限目まとめ

今回は、sales_data_app のAIアドバイス生成に関わる実コードから、

関数

処理をひとまとめにする。

def build_sales_prompt(...):

引数

関数へ値を渡す。

build_sales_prompt(sales_summary)

return

関数から結果を返す。

return ...

関数の呼び出し

作った関数を実際に使う。

prompt = build_sales_prompt(sales_summary)

型ヒント

どんな型を受け取り、どんな型を返す想定なのかを示す。

sales_summary: str

-> str

という5つを学び直しました。

実際の処理では、

関数を作る
↓
引数を受け取る
↓
処理する
↓
returnで返す
↓
別の場所から呼び出す
↓
返ってきた値を変数へ入れる

とつながっています。

そして今回も、

変数
if文
str

など、1時限目で学んだ基礎がもう一度登場しました。

---

🤔 自分で確認してみる

最後に、今回の内容を自分でも確認してみます。

Q1

Pythonで関数を作るときに使うキーワードはどれでしょう？

A. for
B. def
C. if

🅰️答えを見る

B. def

です。

例えば、

def say_hello():

のように書きます。

---

Q2

次のコードで、関数名はどれでしょう？

def build_sales_prompt(sales_summary: str) -> str:

🅰️答えを見る

build_sales_prompt

です。

---

Q3

次のコードでは、何を関数へ渡しているでしょう？

build_sales_prompt(sales_summary)

🅰️答えを見る

sales_summary

です。

売上データをまとめた値を、関数へ渡しています。

---

Q4

returnの役割は何でしょう？

🅰️答えを見る

関数から、

処理した結果を返す

ために使います。

また、returnが実行されると、その関数の処理はそこで終了します。

---

Q5

次の、

sales_summary: str

の str は何を表しているでしょう？

🅰️答えを見る

sales_summary

が、

文字列を受け取る想定であることを示す型ヒント

です。

---

Q6

次の、

-> str

は何を表しているでしょう？

🅰️答えを見る

その関数が、

文字列を返す想定であることを示す型ヒント

です。

---

Q7

次のコードでは、関数から返ってきた値は最終的にどこへ入るでしょう？

prompt = build_sales_prompt(sales_summary)

🅰️答えを見る

prompt

という変数へ入ります。

関数を呼び出す
↓
returnで値が返る
↓
promptへ代入する

という流れです。

---

🐹 3時限目を終えて

今回は、

関数・引数・return・関数の呼び出し・型ヒント

を学び直しました。

最初に、

def build_sales_prompt(sales_summary: str) -> str:

だけを見ると、

🐹「カッコもコロンも矢印もあるし、一気に難しくなったぞ……。」

となりそうです。

でも分解すると、

def
↓
関数を作る

build_sales_prompt
↓
関数の名前

sales_summary
↓
受け取る値

: str
↓
文字列を受け取る想定

-> str
↓
文字列を返す想定

と、一つずつ意味を読むことができました。

さらに、

prompt = build_sales_prompt(sales_summary)

を見ることで、

関数を作る

だけではなく、

作った関数を実際に使う
↓
値を渡す
↓
結果を受け取る

ところまでつなげることができました。

そして3時限目でも、

変数
str
if文

という、これまで学んだ内容がまた登場しました。

新しい基礎を学ぶ
↓
以前の基礎がまた出てくる
↓
別の使われ方を見る
↓
少しずつつながる

今回もこの繰り返しです。

🐹「1時限目と2時限目で掘った穴が、また3時限目につながったね。」

もちろん、今回も記事を1本書いただけで、

「関数を理解した！」

とは考えません。

これから実コードを読んでいて、

def

を見つけたとき、

これは何を受け取る関数だろう？

何をreturnしているんだろう？

どこから呼ばれているんだろう？

と考えられるようになれば、それだけでも以前よりコードの見え方は変わりそうです。

まだまだ基礎の学び直しは続きます。

次の時限も、🍞 sales_data_app の実コードを教材にして掘っていきます🐹

---

📚️ 基礎学習シリーズ

🏫1時限目

「変数・データ型・比較演算子・if文とは？」

🏫2時限目

「リスト・辞書・set・for文とは？」

🏫3時限目

「関数・引数・return・関数の呼び出し・型ヒントとは？」

🏫4時限目

「モジュール・import・例外・try・exceptとは？」