MCP Academy · 课时

为提示词添加参数

让用户在提示词运行前填写各个参数槽位。

为提示词添加参数 是 CoddyKit 上的免费 MCP Academy 课时。这是第 2 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 MCP Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 MCP Academy 课程共包含 4 节课。

本课时的部分内容尚未翻译，以英文显示。

Fillable Slots

A static prompt is fine, but real power comes from arguments: blanks the user fills in before the prompt runs. 🧩

Parameters Become Arguments

Each function parameter becomes a prompt argument. The host shows an input field for every one and collects the values.

@mcp.prompt()
def summarize(text: str) -> str:
    return f"Summarize this:\n{text}"

Slot Values into the Text

Inside the function you weave the arguments into the returned message, usually with an f-string, so the final text is personalized.

Type Hints Describe Inputs

A type hint like str or int tells the client what kind of value to expect, so it can guide and validate the user's entry.

@mcp.prompt()
def plan(topic: str, days: int) -> str:
    return f"Plan {days} days about {topic}."

Required by Default

An argument with no default is required: the user must supply it before the prompt can be invoked. No value, no run.

Optional with Defaults

Give a parameter a default value to make it optional. If the user skips it, your default fills in automatically.

@mcp.prompt()
def summarize(text: str, style: str = "brief") -> str:
    return f"{style} summary:\n{text}"

Document Each Field

Describing arguments well helps the user enter the right thing. Clear field names and a tidy docstring make the form obvious.

Validation at the Edge

The host collects and passes argument values to your function. You can still check them and raise a clear error if something is off.

More Slots, More Reuse

Several arguments turn one prompt into a flexible template. The same review prompt can target bugs, style, or security on demand.

@mcp.prompt()
def review(code: str, focus: str = "bugs") -> str:
    return f"Review this for {focus}:\n{code}"

Keep the Form Short

Ask only for what you truly need. Too many arguments turns a quick template into a tedious form nobody wants to fill.

From Generic to Specific

Arguments let one prompt serve many situations. You write the wording once and the user steers it with a few inputs. 🎯

Quick Check

Let's check how an argument becomes optional.

Recap: Prompt Arguments

You've got it! Function parameters become fillable arguments, type hints describe them, and defaults make them optional. ✅

常见问题解答

「为提示词添加参数」课时是免费的吗？

是的 — 「为提示词添加参数」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 MCP Academy 课程的其余内容，请升级到 CoddyKit PRO。 MCP Academy 课程共包含 4 节课。

「为提示词添加参数」这节课中我会学到什么？

让用户在提示词运行前填写各个参数槽位。你通过在浏览器中直接运行的动手代码来练习 MCP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 MCP Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 MCP Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 2 节课，共 4 节。

「为提示词添加参数」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 MCP Academy 课中编写并运行代码吗？

能。每节 MCP Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 MCP Academy