MCP Academy · 课时

注册您的第一个提示词

为函数添加装饰器以发布提示词。

第 1 / 4 课13 个步骤

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

您的第一个提示

现在来发布一个提示:一种可重复使用、由用户触发的模板,每次都能用精心编写的措辞启动任务。💬

装饰器

使用 @mcp.prompt() 装饰器,可以像使用 @mcp.tool() 标记工具一样,将普通 Python 函数转换为提示。

@mcp.prompt()
def greet() -> str:
    return "Say hello warmly."

名称来自函数

默认情况下,提示的名称就是函数名。客户端会在斜杠菜单中显示这个名称,因此请让它简短清晰。

返回值

最简单的提示会返回一个字符串。当用户选择该提示时,这段文本会成为发送给模型的开场用户消息。

添加描述

函数的文档字符串会成为提示描述。在用户触发提示前,它会告诉用户该提示的用途。

@mcp.prompt()
def greet() -> str:
    """Start a friendly greeting."""
    return "Say hello warmly."

由用户触发,而非自动运行

与工具不同,提示只有在用户明确选择时才会运行。模型不会自行调用提示。

它存在于服务器上

您的提示会注册在保存工具和资源的同一个 FastMCP 服务器实例上。一个服务器,三种基本构件。

mcp = FastMCP("my-server")

@mcp.prompt()
def greet() -> str:
    return "Say hello warmly."

客户端可以列出它

注册后,客户端会调用 prompts/list 来发现它。宿主正是通过这种方式填充斜杠命令或模板菜单的。

选择它,获取消息

用户选择您的提示后,宿主会获取它,并用您返回的文本初始化聊天。用户会从一段润色完善的开场白开始。

让文本聚焦

好的提示正文会为模型提供清晰的指令,而不是堆满各种选项。说明目标和语气,然后停止。

为什么要这样做

注册提示可以避免所有人反复输入相同请求,并让整个团队的措辞保持一致。✨

快速检查

让我们确认提示是如何注册的。

回顾:第一个提示

做得不错!@mcp.prompt() 装饰器会将函数发布为由用户触发的模板,并向用户显示其名称和文档字符串。✅

免费开始

用 AI 导师学习 Python — 免费

在浏览器中编写并运行真实代码,获得全天候 AI 导师的即时帮助,并在网页或应用中继续学习。

课程
30
课程
120

常见问题解答

「注册您的第一个提示词」课时是免费的吗?

是的 — 「注册您的第一个提示词」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 MCP Academy 课程的其余内容,请升级到 CoddyKit PRO。 MCP Academy 课程共包含 4 节课。

「注册您的第一个提示词」这节课中我会学到什么?

为函数添加装饰器以发布提示词。 你通过在浏览器中直接运行的动手代码来练习 MCP Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 MCP Academy 需要有经验吗?

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

「注册您的第一个提示词」课时需要多长时间?

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

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

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

此课程中的所有课时

  1. 注册您的第一个提示词
  2. 为提示词添加参数
  3. 返回消息,而不只是文本
  4. 代码审查提示词模板
← 返回 MCP Academy