返回有用的结果
返回模型和用户都可以使用的文本。
返回有用的结果 是 CoddyKit 上的免费 MCP Academy 课时。 这是第 3 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 MCP Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 MCP Academy 课程共包含 4 节课。
结果会返回给模型
tool 返回的任何内容都会作为上下文反馈给 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返回结构化数据
返回字典或列表时，FastMCP 会将其序列化为 JSON，为模型提供整洁且可解析的字段，而不是松散的叙述性文字。
@mcp.tool()
def stats() -> dict:
return {"users": 12, "active": 9}保持结果简洁
返回的每个词元都会占用模型的上下文预算，因此请将结果精简到真正回答请求所需的内容。噪声越少，回答越精准。
便于阅读的格式
当结果包含多个部分时，适当的结构会很有帮助。简短的带标签行，比一句需要模型费力拆解的长句更好。
将错误作为文本返回
出现问题时，返回清晰的消息可以让模型解释问题并尝试修复，而不是自行猜测。
if not city:
return "Error: city is required."不要返回机密信息
结果会传给模型，并且通常还会传给用户，因此绝不要在返回内容中包含 API 密钥或原始密码之类的机密信息。
保持结构一致会有所帮助
每次调用都返回相同的结构，这样模型才能学会应该期待什么。结构上的意外变化会导致模型误读回答。
兑现 Tool 的承诺
您的结果应该准确提供描述中承诺的内容。如果您说它返回价格，就返回价格，而不是一整份报告。
快速检查
tool 返回 Python 字典时会发生什么？
回顾
您的结果会成为模型的上下文：返回清晰、简洁且能自我说明的文本或 JSON，保持结构一致，并且绝不泄露机密信息。✅
常见问题解答
「返回有用的结果」课时是免费的吗？
是的 — 「返回有用的结果」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 MCP Academy 课程的其余内容，请升级到 CoddyKit PRO。 MCP Academy 课程共包含 4 节课。
「返回有用的结果」这节课中我会学到什么？
返回模型和用户都可以使用的文本。 你通过在浏览器中直接运行的动手代码来练习 MCP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 MCP Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 MCP Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 3 节课，共 4 节。
「返回有用的结果」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 MCP Academy 课中编写并运行代码吗？
能。每节 MCP Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。