役立つ結果を返す
モデルとユーザーが活用できるテキストを返します。
「役立つ結果を返す」はCoddyKit上の無料MCP Academyレッスンです。 これはレッスン3/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはMCP Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 MCP Academyコースには全4レッスンが含まれています。
結果はモデルに戻る
ツールが返すものはすべてコンテキストとしてAIに渡され、ユーザーへの次の回答に影響します。🔁
文字列を返す
最も簡単で役立つ結果は、通常の文字列です。FastMCPはそれを、モデルが直接読めるテキストコンテンツとしてラップします。
@mcp.tool()
def greet(name: str) -> str:
return "Hello, " + nameテキストだけで意味が伝わるようにする
モデルにはほかのコンテキストがないため、テキストだけで意味が伝わる必要があります。「42」だけでなく、「合計は42です」のように返しましょう。
数値は文字列化される
intやfloatを返すと、FastMCPがテキストに変換してくれます。ただし、ラベルを付けるとモデルにとって値が分かりやすくなります。
@mcp.tool()
def add(a: int, b: int) -> int:
return a + b構造化データを返す
dictやlistを返すと、FastMCPはそれをJSONにシリアライズします。まとまりのない文章ではなく、モデルが解析しやすい明確なフィールドを渡せます。
@mcp.tool()
def stats() -> dict:
return {"users": 12, "active": 9}結果を簡潔にする
返すトークンはすべてモデルのコンテキスト予算を消費します。そのため、結果は依頼への回答に実際に必要な内容まで絞りましょう。余計な情報が減れば、回答はより明確になります。
読みやすい形式にする
結果に複数の要素がある場合は、少し構造を持たせると役立ちます。モデルが解読する必要のある長い1文より、短いラベル付きの行が適しています。
エラーはテキストで返す
問題が起きたときは、明確なメッセージを返しましょう。モデルが問題を説明して修正を試みられるため、推測に頼らずに済みます。
if not city:
return "Error: city is required."秘密情報を返さない
結果はモデル、そして多くの場合ユーザーにも届きます。そのため、APIキーや平文のパスワードなどの秘密情報を返す内容に決して含めないでください。
一貫した形式が役立つ
モデルが何を期待すべきか学習できるよう、呼び出しごとに同じ形式で返しましょう。構造が予想外に変わると、回答を誤って解釈する原因になります。
ツールの約束に合わせる
結果は、説明で約束したものを正確に返す必要があります。価格を返すと説明したなら、レポート全体ではなく価格を返しましょう。
クイックチェック
ツールがPythonのdictを返すと、どうなりますか？
リキャップ
結果はモデルのコンテキストになります。明確で簡潔、かつそれだけで意味が伝わるテキストまたはJSONを返し、形式を一貫させ、秘密情報を決して漏らさないようにしましょう。✅
AI チューターと学ぶ Python — 無料
ブラウザでリアルコードを書いて実行し、24/7 の AI チューターから瞬時にサポートを受け、ウェブまたはアプリで続きから学習できます。
- コース
- 30
- レッスン
- 120
よくある質問
「役立つ結果を返す」レッスンは無料ですか？
はい。「役立つ結果を返す」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、MCP Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 MCP Academyコースには全4レッスンが含まれています。
「役立つ結果を返す」で何を学びますか？
モデルとユーザーが活用できるテキストを返します。 ブラウザで直接実行するハンズオンコードでMCP Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
MCP Academyを始めるのに経験は必要ですか？
事前経験は必要ありません。CoddyKitのMCP Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン3/4です。
「役立つ結果を返す」レッスンにはどのくらい時間がかかりますか？
ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このMCP Academyレッスンでコードを書いて実行できますか？
はい。すべてのMCP Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。