{"id":693,"date":"2026-02-06T16:40:17","date_gmt":"2026-02-06T08:40:17","guid":{"rendered":"https:\/\/blog.itsmygo.uk\/2026\/02\/06\/nanobot-%e5%8e%9f%e5%a7%8b%e7%a2%bc%e8%a7%a3%e8%ae%80%ef%bc%9a%e7%94%a8-3400-%e8%a1%8c%e7%a8%8b%e5%bc%8f%e7%a2%bc%e9%87%8d%e5%bb%ba%e4%b8%80%e5%80%8b%e5%ae%8c%e6%95%b4-ai-agent-%e6%a1%86%e6%9e%b6\/"},"modified":"2026-02-06T16:40:17","modified_gmt":"2026-02-06T08:40:17","slug":"nanobot-%e5%8e%9f%e5%a7%8b%e7%a2%bc%e8%a7%a3%e8%ae%80%ef%bc%9a%e7%94%a8-3400-%e8%a1%8c%e7%a8%8b%e5%bc%8f%e7%a2%bc%e9%87%8d%e5%bb%ba%e4%b8%80%e5%80%8b%e5%ae%8c%e6%95%b4-ai-agent-%e6%a1%86%e6%9e%b6","status":"publish","type":"post","link":"https:\/\/blog.itsmygo.uk\/wordpress\/2026\/02\/06\/nanobot-%e5%8e%9f%e5%a7%8b%e7%a2%bc%e8%a7%a3%e8%ae%80%ef%bc%9a%e7%94%a8-3400-%e8%a1%8c%e7%a8%8b%e5%bc%8f%e7%a2%bc%e9%87%8d%e5%bb%ba%e4%b8%80%e5%80%8b%e5%ae%8c%e6%95%b4-ai-agent-%e6%a1%86%e6%9e%b6\/","title":{"rendered":"nanobot \u539f\u59cb\u78bc\u89e3\u8b80\uff1a\u7528 3,400 \u884c\u7a0b\u5f0f\u78bc\u91cd\u5efa\u4e00\u500b\u5b8c\u6574 AI Agent \u6846\u67b6"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">nanobot \u662f\u9999\u6e2f\u5927\u5b78 HKUDS \u5718\u968a\u958b\u6e90\u7684\u8d85\u8f15\u91cf\u7d1a\u500b\u4eba AI \u52a9\u624b\uff0c\u5ba3\u7a31\u53ea\u7528\u7d04 3,400 \u884c\u6838\u5fc3\u7a0b\u5f0f\u78bc\uff0c\u5c31\u5be6\u73fe\u4e86 Claude Code\uff08Clawdbot\uff09430k+ \u884c\u7a0b\u5f0f\u78bc\u4e2d 99% \u7684\u6838\u5fc3\u529f\u80fd\u3002\u9019\u500b\u5c08\u6848\u7684\u50f9\u503c\u4e0d\u53ea\u5728\u65bc\u300c\u5c0f\u300d\uff0c\u66f4\u5728\u65bc\u5b83\u7528\u6975\u7c21\u7684\u8a2d\u8a08\u63ed\u793a\u4e86\u4e00\u500b AI Agent \u6846\u67b6\u7684\u672c\u8cea\u7d50\u69cb\uff1aMessage Bus \u89e3\u8026\u901a\u8a0a\u3001Tool Registry \u52d5\u614b\u64f4\u5c55\u3001Subagent \u80cc\u666f\u4efb\u52d9\u3001Skills \u6f38\u9032\u5f0f\u8f09\u5165\uff0c\u4ee5\u53ca Heartbeat \u4e3b\u52d5\u559a\u9192\u6a5f\u5236\u3002\u8b80\u5b8c\u9019\u4efd\u539f\u59cb\u78bc\uff0c\u4f60\u80fd\u5b78\u5230\u5982\u4f55\u5f9e\u96f6\u8a2d\u8a08\u4e00\u500b\u53ef\u64f4\u5c55\u7684 Agent \u67b6\u69cb\uff0c\u800c\u4e0d\u88ab\u8907\u96dc\u6027\u6df9\u6c92\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/github.com\/HKUDS\/nanobot\">nanobot GitHub Repository<\/a> \u2014 \u5c08\u6848\u539f\u59cb\u78bc\uff0c\u5305\u542b\u672c\u6587\u89e3\u8b80\u7684\u6240\u6709\u8a2d\u8a08\u5be6\u4f5c<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\u5c08\u6848\u6982\u89bd<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">nanobot \u662f\u4e00\u500b Python 3.11+ \u7684 AI Agent \u6846\u67b6\uff0c\u6838\u5fc3\u5b9a\u4f4d\u662f\u300c\u500b\u4eba AI \u52a9\u624b\u300d\u3002\u5b83\u652f\u63f4\u591a\u5bb6 LLM Provider\uff08OpenRouter\u3001Anthropic\u3001OpenAI\u3001DeepSeek\u3001Gemini\u3001vLLM \u7b49\uff09\uff0c\u53ef\u900f\u904e Telegram\u3001Discord\u3001WhatsApp\u3001\u98db\u66f8\u7b49\u901a\u8a0a\u6e20\u9053\u8207\u4f7f\u7528\u8005\u4e92\u52d5\uff0c\u5167\u5efa\u6a94\u6848\u64cd\u4f5c\u3001Shell \u57f7\u884c\u3001\u7db2\u9801\u641c\u5c0b\u3001\u6392\u7a0b\u4efb\u52d9\u3001\u8a18\u61b6\u7cfb\u7d71\u7b49\u5de5\u5177\u3002\u6280\u8853\u68e7\uff1aPython + asyncio + Pydantic + LiteLLM + Typer CLI\uff0c\u4f7f\u7528 hatchling \u6253\u5305\u3002<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\u67b6\u69cb\u7e3d\u89bd<\/h2>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-1\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\">nanobot\/\n\u251c\u2500\u2500 agent\/              <span class=\"hljs-comment\"># \u6838\u5fc3 Agent \u908f\u8f2f<\/span>\n\u2502   \u251c\u2500\u2500 loop.py         <span class=\"hljs-comment\">#   Agent \u4e3b\u8ff4\u5708\uff08LLM \u2194 Tool \u57f7\u884c\uff09<\/span>\n\u2502   \u251c\u2500\u2500 context.py      <span class=\"hljs-comment\">#   Prompt \u7d44\u88dd\u5668\uff08System Prompt Builder\uff09<\/span>\n\u2502   \u251c\u2500\u2500 memory.py       <span class=\"hljs-comment\">#   \u6301\u4e45\u5316\u8a18\u61b6\u7cfb\u7d71<\/span>\n\u2502   \u251c\u2500\u2500 skills.py       <span class=\"hljs-comment\">#   Skills \u8f09\u5165\u8207\u6f38\u9032\u5f0f\u62ab\u9732<\/span>\n\u2502   \u251c\u2500\u2500 subagent.py     <span class=\"hljs-comment\">#   \u80cc\u666f\u5b50\u4ee3\u7406\u7ba1\u7406<\/span>\n\u2502   \u2514\u2500\u2500 tools\/          <span class=\"hljs-comment\">#   \u5de5\u5177\u7cfb\u7d71<\/span>\n\u2502       \u251c\u2500\u2500 base.py     <span class=\"hljs-comment\">#     Tool \u62bd\u8c61\u57fa\u985e\uff08\u542b\u53c3\u6578\u9a57\u8b49\uff09<\/span>\n\u2502       \u251c\u2500\u2500 registry.py <span class=\"hljs-comment\">#     Tool \u8a3b\u518a\u8868<\/span>\n\u2502       \u251c\u2500\u2500 filesystem.py <span class=\"hljs-comment\">#   \u6a94\u6848\u5de5\u5177<\/span>\n\u2502       \u251c\u2500\u2500 shell.py    <span class=\"hljs-comment\">#     Shell \u57f7\u884c\uff08\u542b\u5b89\u5168\u9632\u8b77\uff09<\/span>\n\u2502       \u251c\u2500\u2500 web.py      <span class=\"hljs-comment\">#     \u7db2\u9801\u641c\u5c0b\u8207\u6293\u53d6<\/span>\n\u2502       \u251c\u2500\u2500 spawn.py    <span class=\"hljs-comment\">#     Subagent \u555f\u52d5\u5de5\u5177<\/span>\n\u2502       \u2514\u2500\u2500 message.py  <span class=\"hljs-comment\">#     \u8a0a\u606f\u767c\u9001\u5de5\u5177<\/span>\n\u251c\u2500\u2500 bus\/                <span class=\"hljs-comment\"># \u8a0a\u606f\u532f\u6d41\u6392<\/span>\n\u2502   \u251c\u2500\u2500 events.py       <span class=\"hljs-comment\">#   InboundMessage \/ OutboundMessage<\/span>\n\u2502   \u2514\u2500\u2500 queue.py        <span class=\"hljs-comment\">#   Async Queue + Pub\/Sub<\/span>\n\u251c\u2500\u2500 channels\/           <span class=\"hljs-comment\"># \u901a\u8a0a\u6e20\u9053<\/span>\n\u2502   \u251c\u2500\u2500 base.py         <span class=\"hljs-comment\">#   Channel \u62bd\u8c61\u57fa\u985e<\/span>\n\u2502   \u251c\u2500\u2500 manager.py      <span class=\"hljs-comment\">#   Channel \u7ba1\u7406\u5668<\/span>\n\u2502   \u251c\u2500\u2500 telegram.py     <span class=\"hljs-comment\">#   Telegram \u5be6\u4f5c<\/span>\n\u2502   \u251c\u2500\u2500 discord.py      <span class=\"hljs-comment\">#   Discord \u5be6\u4f5c<\/span>\n\u2502   \u251c\u2500\u2500 whatsapp.py     <span class=\"hljs-comment\">#   WhatsApp \u5be6\u4f5c<\/span>\n\u2502   \u2514\u2500\u2500 feishu.py       <span class=\"hljs-comment\">#   \u98db\u66f8\u5be6\u4f5c<\/span>\n\u251c\u2500\u2500 providers\/          <span class=\"hljs-comment\"># LLM Provider \u5c64<\/span>\n\u2502   \u251c\u2500\u2500 base.py         <span class=\"hljs-comment\">#   LLMProvider \u62bd\u8c61\u4ecb\u9762<\/span>\n\u2502   \u2514\u2500\u2500 litellm_provider.py <span class=\"hljs-comment\"># LiteLLM \u7d71\u4e00\u9069\u914d<\/span>\n\u251c\u2500\u2500 config\/             <span class=\"hljs-comment\"># \u8a2d\u5b9a\u7cfb\u7d71<\/span>\n\u2502   \u251c\u2500\u2500 schema.py       <span class=\"hljs-comment\">#   Pydantic Schema<\/span>\n\u2502   \u2514\u2500\u2500 loader.py       <span class=\"hljs-comment\">#   JSON \u8f09\u5165 + camelCase \u8f49\u63db<\/span>\n\u251c\u2500\u2500 session\/            <span class=\"hljs-comment\"># Session \u7ba1\u7406<\/span>\n\u2502   \u2514\u2500\u2500 manager.py      <span class=\"hljs-comment\">#   JSONL \u6301\u4e45\u5316\u5c0d\u8a71\u6b77\u53f2<\/span>\n\u251c\u2500\u2500 cron\/               <span class=\"hljs-comment\"># \u6392\u7a0b\u4efb\u52d9<\/span>\n\u2502   \u2514\u2500\u2500 service.py      <span class=\"hljs-comment\">#   Cron\/Interval\/One-shot \u6392\u7a0b\u5f15\u64ce<\/span>\n\u251c\u2500\u2500 heartbeat\/          <span class=\"hljs-comment\"># \u5fc3\u8df3\u559a\u9192<\/span>\n\u2502   \u2514\u2500\u2500 service.py      <span class=\"hljs-comment\">#   \u5b9a\u671f\u559a\u9192 Agent \u6aa2\u67e5\u4efb\u52d9<\/span>\n\u251c\u2500\u2500 skills\/             <span class=\"hljs-comment\"># \u5167\u5efa Skills<\/span>\n\u2502   \u251c\u2500\u2500 github\/SKILL.md <span class=\"hljs-comment\">#   GitHub CLI \u64cd\u4f5c\u6307\u5f15<\/span>\n\u2502   \u251c\u2500\u2500 skill-creator\/  <span class=\"hljs-comment\">#   Skill \u5efa\u7acb\u6307\u5357<\/span>\n\u2502   \u2514\u2500\u2500 ...\n\u251c\u2500\u2500 cli\/                <span class=\"hljs-comment\"># CLI \u5165\u53e3<\/span>\n\u2502   \u2514\u2500\u2500 commands.py     <span class=\"hljs-comment\">#   Typer CLI \u547d\u4ee4\u5b9a\u7fa9<\/span>\n\u2514\u2500\u2500 workspace\/          <span class=\"hljs-comment\"># Workspace \u6a21\u677f<\/span>\n    \u251c\u2500\u2500 AGENTS.md       <span class=\"hljs-comment\">#   Agent \u884c\u70ba\u6307\u5f15<\/span>\n    \u251c\u2500\u2500 SOUL.md         <span class=\"hljs-comment\">#   Agent \u4eba\u683c\u8a2d\u5b9a<\/span>\n    \u251c\u2500\u2500 USER.md         <span class=\"hljs-comment\">#   \u4f7f\u7528\u8005\u8cc7\u8a0a\u6a21\u677f<\/span>\n    \u251c\u2500\u2500 TOOLS.md        <span class=\"hljs-comment\">#   \u5de5\u5177\u4f7f\u7528\u8aaa\u660e<\/span>\n    \u2514\u2500\u2500 HEARTBEAT.md    <span class=\"hljs-comment\">#   \u5fc3\u8df3\u4efb\u52d9\u6e05\u55ae<\/span>\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-1\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">\u9019\u500b\u67b6\u69cb\u7684\u6838\u5fc3\u8a2d\u8a08\u54f2\u5b78\u662f\u300c\u5206\u5c64\u89e3\u8026\u300d\uff1aChannel \u5c64\u8ca0\u8cac\u6536\u8a0a\u606f\uff0cBus \u5c64\u8ca0\u8cac\u8def\u7531\uff0cAgent \u5c64\u8ca0\u8cac\u601d\u8003\u548c\u57f7\u884c\uff0cProvider \u5c64\u8ca0\u8cac\u547c\u53eb LLM\u3002\u6bcf\u4e00\u5c64\u90fd\u53ef\u4ee5\u7368\u7acb\u66ff\u63db\u3002<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\u6838\u5fc3\u8a2d\u8a08\u89e3\u6790<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">\u8a2d\u8a08\u4e00\uff1aMessage Bus \u2014 \u7528 asyncio Queue \u5be6\u73fe Channel \u8207 Agent \u7684\u5b8c\u5168\u89e3\u8026<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">nanobot \u6700\u6838\u5fc3\u7684\u67b6\u69cb\u6c7a\u7b56\u4e4b\u4e00\uff0c\u662f\u5728 Channel\uff08\u901a\u8a0a\u6e20\u9053\uff09\u548c Agent\uff08\u6838\u5fc3\u908f\u8f2f\uff09\u4e4b\u9593\u653e\u4e86\u4e00\u500b Message Bus\u3002\u9019\u500b\u8a2d\u8a08\u8b93 Agent \u5b8c\u5168\u4e0d\u9700\u8981\u77e5\u9053\u8a0a\u606f\u4f86\u81ea Telegram \u9084\u662f WhatsApp\uff0cChannel \u4e5f\u4e0d\u9700\u8981\u77e5\u9053 Agent \u600e\u9ebc\u8655\u7406\u8a0a\u606f\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/github.com\/HKUDS\/nanobot\/blob\/main\/nanobot\/bus\/queue.py\"><code>nanobot\/bus\/queue.py<\/code><\/a> \u2014 Message Bus \u5be6\u4f5c\uff0c\u7528\u5169\u500b asyncio.Queue \u5be6\u73fe\u96d9\u5411\u901a\u8a0a<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><span><code class=\"hljs\">class MessageBus:\n    def __init__(self):\n        self.inbound: asyncio.Queue&#91;InboundMessage] = asyncio.Queue()\n        self.outbound: asyncio.Queue&#91;OutboundMessage] = asyncio.Queue()\n        self._outbound_subscribers: dict&#91;str, list&#91;Callable&#91;&#91;OutboundMessage], Awaitable&#91;None]]]] = {}\n<\/code><\/span><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">Bus \u7684\u8a2d\u8a08\u6975\u5176\u7cbe\u7c21\uff1a\u4e00\u500b <code>inbound<\/code> Queue \u8ca0\u8cac\u63a5\u6536\u6240\u6709 Channel \u7684\u8a0a\u606f\uff0c\u4e00\u500b <code>outbound<\/code> Queue \u8ca0\u8cac\u767c\u9001\u56de\u8986\u3002\u51fa\u7ad9\u8a0a\u606f\u652f\u63f4 Pub\/Sub \u6a21\u5f0f \u2014\u2014 Channel \u900f\u904e <code>subscribe_outbound<\/code> \u8a02\u95b1\u81ea\u5df1 channel \u540d\u7a31\u7684\u8a0a\u606f\uff0c<code>dispatch_outbound<\/code> \u65b9\u6cd5\u6703\u6839\u64da <code>msg.channel<\/code> \u6b04\u4f4d\u81ea\u52d5\u8def\u7531\u5230\u6b63\u78ba\u7684 Channel\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/github.com\/HKUDS\/nanobot\/blob\/main\/nanobot\/bus\/events.py\"><code>nanobot\/bus\/events.py<\/code><\/a> \u2014 \u8a0a\u606f\u4e8b\u4ef6\u5b9a\u7fa9\uff0c\u4f7f\u7528 dataclass \u4fdd\u6301\u6975\u7c21<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-2\" data-shcb-language-name=\"CSS\" data-shcb-language-slug=\"css\"><span><code class=\"hljs language-css\"><span class=\"hljs-keyword\">@dataclass<\/span>\nclass <span class=\"hljs-attribute\">InboundMessage:<\/span>\n    <span class=\"hljs-attribute\">channel:<\/span> str      # telegram, discord, whatsapp\n    sender_<span class=\"hljs-attribute\">id:<\/span> str\n    chat_<span class=\"hljs-attribute\">id:<\/span> str\n    <span class=\"hljs-attribute\">content:<\/span> str\n    <span class=\"hljs-attribute\">timestamp:<\/span> datetime = field(default_factory=datetime.now)\n    <span class=\"hljs-attribute\">media:<\/span> list&#91;str] = field(default_factory=list)\n\n    @property\n    def session_key(self) -&gt; <span class=\"hljs-attribute\">str:<\/span>\n        return f<span class=\"hljs-string\">\"{self.channel}:{self.chat_id}\"<\/span>\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-2\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">CSS<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">css<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">\u6ce8\u610f <code>session_key<\/code> \u7684\u8a2d\u8a08 \u2014\u2014 \u7528 <code>channel:chat_id<\/code> \u7d44\u5408\u4f5c\u70ba Session \u7684\u552f\u4e00\u8b58\u5225\u3002\u9019\u610f\u5473\u8457\u540c\u4e00\u500b\u4f7f\u7528\u8005\u5728 Telegram \u548c WhatsApp \u6703\u6709\u4e0d\u540c\u7684 Session\uff0c\u9019\u662f\u6709\u610f\u70ba\u4e4b\u7684\u8a2d\u8a08\u9078\u64c7\uff1a\u6bcf\u500b\u901a\u8a0a\u6e20\u9053\u7dad\u8b77\u7368\u7acb\u7684\u5c0d\u8a71\u4e0a\u4e0b\u6587\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u8a2d\u8a08\u4e8c\uff1aAgent Loop \u2014 \u7d93\u5178\u7684 LLM \u2194 Tool \u8ff4\u5708<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Agent \u7684\u6838\u5fc3\u662f\u4e00\u500b while \u8ff4\u5708\uff1a\u547c\u53eb LLM \u2192 \u5982\u679c\u6709 tool call \u5c31\u57f7\u884c \u2192 \u628a\u7d50\u679c\u9935\u56de LLM \u2192 \u91cd\u8907\u76f4\u5230 LLM \u7d14\u6587\u5b57\u56de\u8986\u3002\u9019\u662f ReAct \u6a21\u5f0f\u7684\u76f4\u63a5\u5be6\u4f5c\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/github.com\/HKUDS\/nanobot\/blob\/main\/nanobot\/agent\/loop.py\"><code>nanobot\/agent\/loop.py<\/code><\/a> \u2014 Agent \u4e3b\u8ff4\u5708\uff0c\u6574\u500b\u6846\u67b6\u7684\u5fc3\u81df<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-3\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\"><span class=\"hljs-keyword\">while<\/span> iteration &lt; <span class=\"hljs-keyword\">self<\/span>.max_iterations:\n    iteration += <span class=\"hljs-number\">1<\/span>\n    response = await <span class=\"hljs-keyword\">self<\/span>.provider.chat(\n        messages=messages,\n        tools=<span class=\"hljs-keyword\">self<\/span>.tools.get_definitions(),\n        model=<span class=\"hljs-keyword\">self<\/span>.model\n    )\n    <span class=\"hljs-keyword\">if<\/span> response.has_tool_calls:\n        messages = <span class=\"hljs-keyword\">self<\/span>.context.add_assistant_message(\n            messages, response.content, tool_call_dicts\n        )\n        <span class=\"hljs-keyword\">for<\/span> tool_call in response.tool_calls:\n            result = await <span class=\"hljs-keyword\">self<\/span>.tools.execute(tool_call.name, tool_call.arguments)\n            messages = <span class=\"hljs-keyword\">self<\/span>.context.add_tool_result(\n                messages, tool_call.id, tool_call.name, result\n            )\n    <span class=\"hljs-keyword\">else<\/span>:\n        final_content = response.content\n        <span class=\"hljs-keyword\">break<\/span>\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-3\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">\u95dc\u9375\u8a2d\u8a08\u6c7a\u7b56\uff1a<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n\n<li><strong><code>max_iterations<\/code> \u9650\u5236<\/strong>\uff1a\u9810\u8a2d 20 \u6b21\u8fed\u4ee3\u4e0a\u9650\uff0c\u9632\u6b62 Agent \u7121\u9650\u8ff4\u5708\u3002\u9019\u662f\u4e00\u500b\u7c21\u55ae\u4f46\u5fc5\u8981\u7684\u5b89\u5168\u95a5\u3002<\/li>\n\n\n<li><strong>Session \u6301\u4e45\u5316\u53ea\u4fdd\u5b58\u6700\u7d42\u7d50\u679c<\/strong>\uff1a\u53ea\u6709\u8ff4\u5708\u7d50\u675f\u5f8c\u7684 user input \u548c final response \u624d\u6703\u5beb\u5165 Session\uff0c\u4e2d\u9593\u7684 tool call \u904e\u7a0b\u4e0d\u4fdd\u5b58\u3002\u9019\u5927\u5e45\u7bc0\u7701\u4e86 Session \u6a94\u6848\u7684\u5927\u5c0f\u3002<\/li>\n\n\n<li><strong>System message \u8def\u7531\u6a5f\u5236<\/strong>\uff1a\u7576 <code>msg.channel == \"system\"<\/code> \u6642\uff0c\u8d70\u4e0d\u540c\u7684\u8655\u7406\u908f\u8f2f\u3002Subagent \u5b8c\u6210\u5f8c\u7684\u56de\u5831\u5c31\u662f\u900f\u904e\u9019\u500b\u7ba1\u9053\uff0cchat_id \u683c\u5f0f\u70ba <code>\"original_channel:original_chat_id\"<\/code>\uff0c\u5be6\u73fe\u4e86\u8de8 channel \u7684\u7d50\u679c\u56de\u50b3\u3002<\/li>\n\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\">\u8a2d\u8a08\u4e09\uff1aTool \u7cfb\u7d71 \u2014 \u62bd\u8c61\u57fa\u985e + Registry \u52d5\u614b\u8a3b\u518a<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Tool \u7cfb\u7d71\u7684\u8a2d\u8a08\u9075\u5faa\u4e86\u300c\u5b9a\u7fa9\u8207\u57f7\u884c\u5206\u96e2\u300d\u7684\u539f\u5247\u3002\u6bcf\u500b Tool \u9700\u8981\u5be6\u4f5c\u56db\u500b\u5143\u7d20\uff1a<code>name<\/code>\u3001<code>description<\/code>\u3001<code>parameters<\/code>\uff08JSON Schema\uff09\u3001<code>execute<\/code> \u65b9\u6cd5\u3002Registry \u8ca0\u8cac\u7d71\u4e00\u7ba1\u7406\u548c\u547c\u53eb\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/github.com\/HKUDS\/nanobot\/blob\/main\/nanobot\/agent\/tools\/base.py\"><code>nanobot\/agent\/tools\/base.py<\/code><\/a> \u2014 Tool \u62bd\u8c61\u57fa\u985e\uff0c\u5305\u542b\u5167\u5efa\u7684 JSON Schema \u53c3\u6578\u9a57\u8b49<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><span><code class=\"hljs\">class Tool(ABC):\n    _TYPE_MAP = {\n        \"string\": str, \"integer\": int, \"number\": (int, float),\n        \"boolean\": bool, \"array\": list, \"object\": dict,\n    }\n\n    @property\n    @abstractmethod\n    def name(self) -&gt; str: ...\n\n    @property\n    @abstractmethod\n    def parameters(self) -&gt; dict&#91;str, Any]: ...\n\n    @abstractmethod\n    async def execute(self, **kwargs: Any) -&gt; str: ...\n\n    def validate_params(self, params: dict&#91;str, Any]) -&gt; list&#91;str]:\n        \"\"\"Validate tool parameters against JSON schema.\"\"\"\n        ...\n\n    def to_schema(self) -&gt; dict&#91;str, Any]:\n        return {\n            \"type\": \"function\",\n            \"function\": {\n                \"name\": self.name,\n                \"description\": self.description,\n                \"parameters\": self.parameters,\n            }\n        }\n<\/code><\/span><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">\u4eae\u9ede\u5728\u65bc <code>validate_params<\/code> \u65b9\u6cd5 \u2014\u2014 Tool \u57fa\u985e\u81ea\u5e36\u4e86\u4e00\u500b\u905e\u6b78\u7684 JSON Schema \u9a57\u8b49\u5668\uff0c\u5728\u57f7\u884c\u524d\u5148\u6aa2\u67e5 LLM \u56de\u50b3\u7684\u53c3\u6578\u662f\u5426\u5408\u6cd5\u3002\u9019\u907f\u514d\u4e86\u5728\u6bcf\u500b Tool \u5be6\u4f5c\u4e2d\u91cd\u8907\u5beb\u9a57\u8b49\u908f\u8f2f\u3002\u800c <code>to_schema<\/code> \u65b9\u6cd5\u76f4\u63a5\u8f38\u51fa OpenAI function calling \u683c\u5f0f\uff0c\u8b93 Tool \u7684\u5b9a\u7fa9\u548c LLM API \u898f\u683c\u7121\u7e2b\u5c0d\u63a5\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/github.com\/HKUDS\/nanobot\/blob\/main\/nanobot\/agent\/tools\/registry.py\"><code>nanobot\/agent\/tools\/registry.py<\/code><\/a> \u2014 Tool Registry\uff0c\u7528 dict \u7ba1\u7406\u6240\u6709\u5df2\u8a3b\u518a\u7684\u5de5\u5177<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><span><code class=\"hljs\">class ToolRegistry:\n    def __init__(self):\n        self._tools: dict&#91;str, Tool] = {}\n\n    def register(self, tool: Tool) -&gt; None:\n        self._tools&#91;tool.name] = tool\n\n    async def execute(self, name: str, params: dict&#91;str, Any]) -&gt; str:\n        tool = self._tools.get(name)\n        if not tool:\n            return f\"Error: Tool '{name}' not found\"\n        errors = tool.validate_params(params)\n        if errors:\n            return f\"Error: Invalid parameters: \" + \"; \".join(errors)\n        return await tool.execute(**params)\n<\/code><\/span><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">Registry \u7684 <code>execute<\/code> \u65b9\u6cd5\u628a\u300c\u67e5\u627e \u2192 \u9a57\u8b49 \u2192 \u57f7\u884c \u2192 \u932f\u8aa4\u8655\u7406\u300d\u7d71\u4e00\u5c01\u88dd\uff0cAgent Loop \u53ea\u9700\u8981\u547c\u53eb <code>self.tools.execute(name, args)<\/code> \u4e00\u884c\u7a0b\u5f0f\u78bc\u3002\u932f\u8aa4\u4e0d\u62cb\u7570\u5e38\u800c\u662f\u56de\u50b3\u932f\u8aa4\u5b57\u4e32\uff0c\u8b93 LLM \u770b\u5230\u932f\u8aa4\u8a0a\u606f\u5f8c\u53ef\u4ee5\u81ea\u6211\u4fee\u6b63\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u8a2d\u8a08\u56db\uff1aShell \u5b89\u5168\u9632\u8b77 \u2014 Deny Pattern \u9ed1\u540d\u55ae\u6a5f\u5236<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u8ce6\u4e88 LLM \u57f7\u884c Shell \u547d\u4ee4\u7684\u80fd\u529b\u662f\u4e00\u628a\u96d9\u9762\u5203\u3002nanobot \u7528 regex deny pattern \u5be6\u73fe\u4e86\u4e00\u5c64\u5b89\u5168\u9632\u8b77\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/github.com\/HKUDS\/nanobot\/blob\/main\/nanobot\/agent\/tools\/shell.py\"><code>nanobot\/agent\/tools\/shell.py<\/code><\/a> \u2014 Shell \u57f7\u884c\u5de5\u5177\uff0c\u5305\u542b\u5371\u96aa\u6307\u4ee4\u6514\u622a<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><span><code class=\"hljs\">class ExecTool(Tool):\n    def __init__(self, ...):\n        self.deny_patterns = deny_patterns or &#91;\n            r\"\\brm\\s+-&#91;rf]{1,2}\\b\",           # rm -r, rm -rf\n            r\"\\b(format|mkfs|diskpart)\\b\",     # disk operations\n            r\"\\bdd\\s+if=\",                     # dd\n            r\"\\b(shutdown|reboot|poweroff)\\b\", # system power\n            r\":\\(\\)\\s*\\{.*\\};\\s*:\",            # fork bomb\n        ]\n\n    def _guard_command(self, command: str, cwd: str) -&gt; str | None:\n        for pattern in self.deny_patterns:\n            if re.search(pattern, lower):\n                return \"Error: Command blocked by safety guard\"\n<\/code><\/span><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">\u8a2d\u8a08\u7279\u9ede\uff1a<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n\n<li><strong>\u9ed1\u540d\u55ae\u800c\u975e\u767d\u540d\u55ae<\/strong>\uff1a\u9810\u8a2d\u5141\u8a31\u6240\u6709\u547d\u4ee4\uff0c\u53ea\u6514\u622a\u5df2\u77e5\u5371\u96aa\u64cd\u4f5c\u3002\u9019\u7b26\u5408\u300c\u500b\u4eba\u52a9\u624b\u300d\u7684\u5b9a\u4f4d \u2014\u2014 \u4f7f\u7528\u8005\u9700\u8981\u9748\u6d3b\u6027\u3002<\/li>\n\n\n<li><strong>\u53ef\u9078\u7684 workspace \u8def\u5f91\u9650\u5236<\/strong>\uff1a<code>restrict_to_workspace<\/code> \u9078\u9805\u958b\u555f\u5f8c\u6703\u6514\u622a\u8def\u5f91\u7a7f\u8d8a\uff08<code>..\/<\/code>\uff09\u548c workspace \u5916\u7684\u8def\u5f91\u3002<\/li>\n\n\n<li><strong>\u8f38\u51fa\u622a\u65b7<\/strong>\uff1a\u6700\u9577 10,000 \u5b57\u5143\uff0c\u9632\u6b62\u5927\u91cf\u8f38\u51fa\u585e\u6eff LLM context window\u3002<\/li>\n\n\n<li><strong>Timeout \u4fdd\u8b77<\/strong>\uff1a\u9810\u8a2d 60 \u79d2\u8d85\u6642\uff0c\u907f\u514d hang \u4f4f\u6574\u500b\u7cfb\u7d71\u3002<\/li>\n\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\">\u8a2d\u8a08\u4e94\uff1aContext Builder \u2014 \u6a21\u7d44\u5316\u7684 System Prompt \u7d44\u88dd<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">nanobot \u4e0d\u662f\u628a System Prompt \u5beb\u6b7b\u5728\u7a0b\u5f0f\u78bc\u88e1\uff0c\u800c\u662f\u5f9e\u591a\u500b\u4f86\u6e90\u52d5\u614b\u7d44\u88dd\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/github.com\/HKUDS\/nanobot\/blob\/main\/nanobot\/agent\/context.py\"><code>nanobot\/agent\/context.py<\/code><\/a> \u2014 Prompt \u7d44\u88dd\u5668\uff0c\u5f9e workspace \u6a94\u6848\u52d5\u614b\u5efa\u69cb System Prompt<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><span><code class=\"hljs\">class ContextBuilder:\n    BOOTSTRAP_FILES = &#91;\"AGENTS.md\", \"SOUL.md\", \"USER.md\", \"TOOLS.md\", \"IDENTITY.md\"]\n\n    def build_system_prompt(self, skill_names: list&#91;str] | None = None) -&gt; str:\n        parts = &#91;]\n        parts.append(self._get_identity())      # \u6838\u5fc3\u8eab\u4efd\n        bootstrap = self._load_bootstrap_files() # Workspace \u8a2d\u5b9a\u6a94\n        if bootstrap:\n            parts.append(bootstrap)\n        memory = self.memory.get_memory_context() # \u8a18\u61b6\n        if memory:\n            parts.append(f\"# Memory\\n\\n{memory}\")\n        # Skills...\n        return \"\\n\\n---\\n\\n\".join(parts)\n<\/code><\/span><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">System Prompt \u7531\u4e94\u5c64\u7d44\u88dd\u800c\u6210\uff1a<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n\n<li><strong>Identity<\/strong>\uff1a\u786c\u7de8\u78bc\u7684\u6838\u5fc3\u8eab\u4efd\uff08\u5305\u542b\u6642\u9593\u3001\u7cfb\u7d71\u8cc7\u8a0a\u3001workspace \u8def\u5f91\uff09<\/li>\n\n\n<li><strong>Bootstrap Files<\/strong>\uff1a\u5f9e workspace \u76ee\u9304\u8b80\u53d6 <code>AGENTS.md<\/code>\u3001<code>SOUL.md<\/code>\u3001<code>USER.md<\/code> \u7b49\u8a2d\u5b9a\u6a94<\/li>\n\n\n<li><strong>Memory<\/strong>\uff1a\u9577\u671f\u8a18\u61b6\uff08<code>MEMORY.md<\/code>\uff09\u548c\u7576\u65e5\u7b46\u8a18<\/li>\n\n\n<li><strong>Always-on Skills<\/strong>\uff1a\u6a19\u8a18\u70ba <code>always=true<\/code> \u7684 Skill \u5168\u6587\u8f09\u5165<\/li>\n\n\n<li><strong>Skills Summary<\/strong>\uff1a\u5176\u4ed6\u53ef\u7528 Skills \u53ea\u8f09\u5165\u6458\u8981\uff0c\u9700\u8981\u6642\u518d\u7528 <code>read_file<\/code> \u8b80\u53d6<\/li>\n\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">\u9019\u500b\u8a2d\u8a08\u8b93\u4f7f\u7528\u8005\u4e0d\u9700\u8981\u6539\u7a0b\u5f0f\u78bc\uff0c\u53ea\u8981\u7de8\u8f2f workspace \u88e1\u7684 Markdown \u6a94\u6848\uff0c\u5c31\u80fd\u81ea\u8a02 Agent \u7684\u884c\u70ba\u3001\u4eba\u683c\u548c\u77e5\u8b58\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u8a2d\u8a08\u516d\uff1aSubagent \u2014 \u8f15\u91cf\u7d1a\u80cc\u666f\u4efb\u52d9\u67b6\u69cb<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">nanobot \u652f\u63f4\u4e3b Agent \u900f\u904e <code>spawn<\/code> \u5de5\u5177\u555f\u52d5\u5b50\u4ee3\u7406\uff08Subagent\uff09\u4f86\u8655\u7406\u8017\u6642\u4efb\u52d9\u3002Subagent \u7684\u8a2d\u8a08\u5de7\u5999\u5730\u5e73\u8861\u4e86\u80fd\u529b\u548c\u5b89\u5168\u6027\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/github.com\/HKUDS\/nanobot\/blob\/main\/nanobot\/agent\/subagent.py\"><code>nanobot\/agent\/subagent.py<\/code><\/a> \u2014 Subagent \u7ba1\u7406\u5668\uff0c\u7528 asyncio.Task \u5be6\u73fe\u80cc\u666f\u57f7\u884c<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><span><code class=\"hljs\">class SubagentManager:\n    async def spawn(self, task: str, label: str | None = None, ...) -&gt; str:\n        task_id = str(uuid.uuid4())&#91;:8]\n        bg_task = asyncio.create_task(\n            self._run_subagent(task_id, task, display_label, origin)\n        )\n        self._running_tasks&#91;task_id] = bg_task\n        bg_task.add_done_callback(lambda _: self._running_tasks.pop(task_id, None))\n        return f\"Subagent &#91;{display_label}] started (id: {task_id}).\"\n<\/code><\/span><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">Subagent \u7684\u6b0a\u9650\u88ab\u523b\u610f\u9650\u7e2e\uff1a<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li><strong>\u53ef\u4ee5<\/strong>\uff1a\u8b80\u5beb\u6a94\u6848\u3001\u57f7\u884c Shell\u3001\u641c\u5c0b\u7db2\u9801<\/li>\n\n\n<li><strong>\u4e0d\u53ef\u4ee5<\/strong>\uff1a\u767c\u9001\u8a0a\u606f\u7d66\u4f7f\u7528\u8005\uff08\u6c92\u6709 message tool\uff09\u3001\u518d spawn \u5b50\u4ee3\u7406\uff08\u6c92\u6709 spawn tool\uff09<\/li>\n\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\u5b8c\u6210\u5f8c\u7684\u7d50\u679c\u900f\u904e Message Bus \u7684 <code>system<\/code> channel \u56de\u5831\uff0cchat_id \u7de8\u78bc\u70ba <code>\"origin_channel:origin_chat_id\"<\/code> \u683c\u5f0f\uff0c\u8b93\u4e3b Agent \u77e5\u9053\u8981\u628a\u7d50\u679c\u767c\u9001\u5230\u54ea\u88e1\uff1a<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-4\" data-shcb-language-name=\"JavaScript\" data-shcb-language-slug=\"javascript\"><span><code class=\"hljs language-javascript\"><span class=\"hljs-keyword\">async<\/span> def _announce_result(self, ...):\n    msg = InboundMessage(\n        channel=<span class=\"hljs-string\">\"system\"<\/span>,\n        sender_id=<span class=\"hljs-string\">\"subagent\"<\/span>,\n        chat_id=f<span class=\"hljs-string\">\"{origin&#91;'channel']}:{origin&#91;'chat_id']}\"<\/span>,\n        content=announce_content,\n    )\n    <span class=\"hljs-keyword\">await<\/span> self.bus.publish_inbound(msg)\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-4\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">JavaScript<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">javascript<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<h3 class=\"wp-block-heading\">\u8a2d\u8a08\u4e03\uff1aSkills \u6f38\u9032\u5f0f\u8f09\u5165 \u2014 \u4e09\u5c64 Progressive Disclosure<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Skills \u7cfb\u7d71\u7684\u8a2d\u8a08\u89e3\u6c7a\u4e86\u4e00\u500b\u6838\u5fc3\u77db\u76fe\uff1aAgent \u9700\u8981\u77e5\u9053\u5f88\u591a\u80fd\u529b\uff0c\u4f46 LLM \u7684 context window \u6709\u9650\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/github.com\/HKUDS\/nanobot\/blob\/main\/nanobot\/agent\/skills.py\"><code>nanobot\/agent\/skills.py<\/code><\/a> \u2014 Skills \u8f09\u5165\u5668\uff0c\u5be6\u73fe\u4e09\u5c64\u6f38\u9032\u5f0f\u8f09\u5165<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-5\" data-shcb-language-name=\"HTML, XML\" data-shcb-language-slug=\"xml\"><span><code class=\"hljs language-xml\">class SkillsLoader:\n    def build_skills_summary(self) -&gt; str:\n        lines = &#91;\"<span class=\"hljs-tag\">&lt;<span class=\"hljs-name\">skills<\/span>&gt;<\/span>\"]\n        for s in all_skills:\n            lines.append(f\"  <span class=\"hljs-tag\">&lt;<span class=\"hljs-name\">skill<\/span> <span class=\"hljs-attr\">available<\/span>=<span class=\"hljs-string\">\\<\/span>\"{<span class=\"hljs-attr\">str<\/span>(<span class=\"hljs-attr\">available<\/span>)<span class=\"hljs-attr\">.lower<\/span>()}\\\"&gt;<\/span>\")\n            lines.append(f\"    <span class=\"hljs-tag\">&lt;<span class=\"hljs-name\">name<\/span>&gt;<\/span>{name}<span class=\"hljs-tag\">&lt;\/<span class=\"hljs-name\">name<\/span>&gt;<\/span>\")\n            lines.append(f\"    <span class=\"hljs-tag\">&lt;<span class=\"hljs-name\">description<\/span>&gt;<\/span>{desc}<span class=\"hljs-tag\">&lt;\/<span class=\"hljs-name\">description<\/span>&gt;<\/span>\")\n            lines.append(f\"    <span class=\"hljs-tag\">&lt;<span class=\"hljs-name\">location<\/span>&gt;<\/span>{path}<span class=\"hljs-tag\">&lt;\/<span class=\"hljs-name\">location<\/span>&gt;<\/span>\")\n            lines.append(f\"  <span class=\"hljs-tag\">&lt;\/<span class=\"hljs-name\">skill<\/span>&gt;<\/span>\")\n        lines.append(\"<span class=\"hljs-tag\">&lt;\/<span class=\"hljs-name\">skills<\/span>&gt;<\/span>\")\n        return \"\\n\".join(lines)\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-5\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">HTML, XML<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">xml<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">\u4e09\u5c64\u8f09\u5165\u7b56\u7565\uff1a<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table>\n<thead>\n<tr>\n<th>\u5c64\u7d1a<\/th>\n<th>\u4f55\u6642\u8f09\u5165<\/th>\n<th>Token \u6210\u672c<\/th>\n<th>\u5167\u5bb9<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>L1: Metadata<\/td>\n<td>\u6c38\u9060\u8f09\u5165<\/td>\n<td>~100 tokens\/skill<\/td>\n<td>\u540d\u7a31 + \u63cf\u8ff0<\/td>\n<\/tr>\n<tr>\n<td>L2: SKILL.md<\/td>\n<td>Agent \u5224\u65b7\u9700\u8981\u6642<\/td>\n<td>~500-2000 tokens<\/td>\n<td>\u5b8c\u6574\u64cd\u4f5c\u6307\u5f15<\/td>\n<\/tr>\n<tr>\n<td>L3: Resources<\/td>\n<td>\u5177\u9ad4\u64cd\u4f5c\u6642<\/td>\n<td>\u4e0d\u9650<\/td>\n<td>\u8173\u672c\u3001\u53c3\u8003\u6587\u4ef6\u3001\u8cc7\u6e90<\/td>\n<\/tr>\n<\/tbody>\n<\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Skills \u9084\u6709\u4e00\u500b\u7cbe\u5de7\u7684\u8a2d\u8a08 \u2014\u2014 <strong>\u9700\u6c42\u6aa2\u67e5<\/strong>\uff1a\u6bcf\u500b Skill \u53ef\u4ee5\u5728 metadata \u4e2d\u5ba3\u544a\u9700\u8981\u7684 binary\uff08\u5982 <code>gh<\/code> CLI\uff09\u548c\u74b0\u5883\u8b8a\u6578\u3002\u8f09\u5165\u5668\u6703\u5728\u555f\u52d5\u6642\u6aa2\u67e5\u9019\u4e9b\u4f9d\u8cf4\u662f\u5426\u5b58\u5728\uff0c\u4e0d\u7b26\u5408\u7684 Skill \u6703\u6a19\u8a18\u70ba <code>available=\"false\"<\/code> \u4e26\u63d0\u793a\u7f3a\u5c11\u4ec0\u9ebc\u3002<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-6\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\">def _check_requirements(<span class=\"hljs-keyword\">self<\/span>, skill_meta: dict) -&gt; bool:\n    requires = skill_meta.get(<span class=\"hljs-string\">\"requires\"<\/span>, {})\n    <span class=\"hljs-keyword\">for<\/span> b in requires.get(<span class=\"hljs-string\">\"bins\"<\/span>, &#91;]):\n        <span class=\"hljs-keyword\">if<\/span> not shutil.which(b):\n            <span class=\"hljs-keyword\">return<\/span> <span class=\"hljs-keyword\">False<\/span>\n    <span class=\"hljs-keyword\">for<\/span> env in requires.get(<span class=\"hljs-string\">\"env\"<\/span>, &#91;]):\n        <span class=\"hljs-keyword\">if<\/span> not os.environ.get(env):\n            <span class=\"hljs-keyword\">return<\/span> <span class=\"hljs-keyword\">False<\/span>\n    <span class=\"hljs-keyword\">return<\/span> <span class=\"hljs-keyword\">True<\/span>\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-6\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<h3 class=\"wp-block-heading\">\u8a2d\u8a08\u516b\uff1aLLM Provider \u62bd\u8c61 \u2014 \u7528 LiteLLM \u5be6\u73fe\u591a Provider \u7d71\u4e00\u4ecb\u9762<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">nanobot \u6c92\u6709\u81ea\u5df1\u5beb\u5404\u5bb6 LLM \u7684 API \u5c0d\u63a5\uff0c\u800c\u662f\u7ad9\u5728 LiteLLM \u80a9\u8180\u4e0a\uff0c\u52a0\u4e86\u4e00\u5c64\u8584\u5305\u88dd\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/github.com\/HKUDS\/nanobot\/blob\/main\/nanobot\/providers\/base.py\"><code>nanobot\/providers\/base.py<\/code><\/a> \u2014 LLM Provider \u62bd\u8c61\u4ecb\u9762\uff0c\u5b9a\u7fa9\u7d71\u4e00\u7684 chat \u65b9\u6cd5<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-7\" data-shcb-language-name=\"CSS\" data-shcb-language-slug=\"css\"><span><code class=\"hljs language-css\"><span class=\"hljs-keyword\">@dataclass<\/span>\nclass <span class=\"hljs-attribute\">LLMResponse:<\/span>\n    <span class=\"hljs-attribute\">content:<\/span> str | None\n    tool_<span class=\"hljs-attribute\">calls:<\/span> list&#91;ToolCallRequest] = field(default_factory=list)\n    finish_<span class=\"hljs-attribute\">reason:<\/span> str = <span class=\"hljs-string\">\"stop\"<\/span>\n    <span class=\"hljs-attribute\">usage:<\/span> dict&#91;str, int] = field(default_factory=dict)\n\n    @property\n    def has_tool_calls(self) -&gt; <span class=\"hljs-attribute\">bool:<\/span>\n        return len(self.tool_calls) &gt; <span class=\"hljs-number\">0<\/span>\n\nclass LLMProvider(ABC):\n    @abstractmethod\n    async def chat(self, messages, tools, model, ...) -&gt; <span class=\"hljs-attribute\">LLMResponse:<\/span> ...\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-7\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">CSS<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">css<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/github.com\/HKUDS\/nanobot\/blob\/main\/nanobot\/providers\/litellm_provider.py\"><code>nanobot\/providers\/litellm_provider.py<\/code><\/a> \u2014 LiteLLM \u5be6\u4f5c\uff0c\u8655\u7406\u591a Provider \u7684 model prefix \u908f\u8f2f<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">LiteLLM Provider \u7684\u6838\u5fc3\u5de5\u4f5c\u662f\u8655\u7406\u5404\u5bb6 Provider \u7684 model \u540d\u7a31\u524d\u7db4\uff1a<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-8\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\"><span class=\"hljs-keyword\">if<\/span> <span class=\"hljs-keyword\">self<\/span>.is_openrouter <span class=\"hljs-keyword\">and<\/span> not model.startswith(<span class=\"hljs-string\">\"openrouter\/\"<\/span>):\n    model = f<span class=\"hljs-string\">\"openrouter\/{model}\"<\/span>\n<span class=\"hljs-keyword\">if<\/span> <span class=\"hljs-keyword\">self<\/span>.is_vllm:\n    model = f<span class=\"hljs-string\">\"hosted_vllm\/{model}\"<\/span>\n<span class=\"hljs-keyword\">if<\/span> <span class=\"hljs-string\">\"gemini\"<\/span> in model.lower() <span class=\"hljs-keyword\">and<\/span> not model.startswith(<span class=\"hljs-string\">\"gemini\/\"<\/span>):\n    model = f<span class=\"hljs-string\">\"gemini\/{model}\"<\/span>\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-8\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">\u4ee5\u53ca\u5c07 LLM \u56de\u50b3\u7684\u932f\u8aa4\u5305\u88dd\u6210 content \u800c\u4e0d\u662f\u62cb\u7570\u5e38\uff0c\u8b93 Agent \u53ef\u4ee5 graceful \u5730\u8655\u7406 LLM \u932f\u8aa4\uff1a<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-9\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\">except <span class=\"hljs-keyword\">Exception<\/span> <span class=\"hljs-keyword\">as<\/span> e:\n    <span class=\"hljs-keyword\">return<\/span> LLMResponse(\n        content=f<span class=\"hljs-string\">\"Error calling LLM: {str(e)}\"<\/span>,\n        finish_reason=<span class=\"hljs-string\">\"error\"<\/span>,\n    )\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-9\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<h3 class=\"wp-block-heading\">\u8a2d\u8a08\u4e5d\uff1aChannel \u62bd\u8c61 \u2014 \u7d71\u4e00\u7684\u804a\u5929\u5e73\u53f0\u6574\u5408\u6a21\u5f0f<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u6240\u6709\u804a\u5929\u5e73\u53f0\u90fd\u9075\u5faa\u540c\u4e00\u500b\u62bd\u8c61\uff1a<code>start<\/code>\uff08\u958b\u59cb\u76e3\u807d\uff09\u3001<code>stop<\/code>\uff08\u505c\u6b62\uff09\u3001<code>send<\/code>\uff08\u767c\u9001\u8a0a\u606f\uff09\uff0c\u4ee5\u53ca\u4e00\u500b\u5167\u5efa\u7684 <code>_handle_message<\/code> \u65b9\u6cd5\u505a\u6b0a\u9650\u6aa2\u67e5\u548c\u8a0a\u606f\u8def\u7531\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/github.com\/HKUDS\/nanobot\/blob\/main\/nanobot\/channels\/base.py\"><code>nanobot\/channels\/base.py<\/code><\/a> \u2014 Channel \u62bd\u8c61\u57fa\u985e\uff0c\u5b9a\u7fa9\u804a\u5929\u5e73\u53f0\u7684\u7d71\u4e00\u4ecb\u9762<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><span><code class=\"hljs\">class BaseChannel(ABC):\n    def is_allowed(self, sender_id: str) -&gt; bool:\n        allow_list = getattr(self.config, \"allow_from\", &#91;])\n        if not allow_list:\n            return True  # \u7a7a\u5217\u8868 = \u5141\u8a31\u6240\u6709\u4eba\n        return str(sender_id) in allow_list\n\n    async def _handle_message(self, sender_id, chat_id, content, ...):\n        if not self.is_allowed(sender_id):\n            return\n        msg = InboundMessage(channel=self.name, ...)\n        await self.bus.publish_inbound(msg)\n<\/code><\/span><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\"><code>is_allowed<\/code> \u7684\u767d\u540d\u55ae\u8a2d\u8a08\u662f\u5b89\u5168\u8003\u91cf \u2014\u2014 \u9019\u662f\u500b\u300c\u500b\u4eba\u52a9\u624b\u300d\uff0c\u4e0d\u61c9\u8a72\u8b93\u964c\u751f\u4eba\u4f7f\u7528\u3002\u7a7a\u5217\u8868\u8868\u793a\u300c\u5141\u8a31\u6240\u6709\u4eba\u300d\u7684\u8a2d\u8a08\uff0c\u8b93\u4f7f\u7528\u8005\u5728\u6e2c\u8a66\u968e\u6bb5\u53ef\u4ee5\u5feb\u901f\u4e0a\u624b\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/github.com\/HKUDS\/nanobot\/blob\/main\/nanobot\/channels\/manager.py\"><code>nanobot\/channels\/manager.py<\/code><\/a> \u2014 Channel \u7ba1\u7406\u5668\uff0c\u6309\u9700\u521d\u59cb\u5316\u548c\u8def\u7531\u8a0a\u606f<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Channel Manager \u7528\u4e86 lazy import \u6a21\u5f0f \u2014\u2014 \u53ea\u5728 config \u4e2d\u555f\u7528\u67d0\u500b channel \u6642\u624d import \u5c0d\u61c9\u7684\u6a21\u7d44\u3002\u9019\u907f\u514d\u4e86\u672a\u5b89\u88dd\u67d0\u500b SDK \u6642\u6574\u500b\u7cfb\u7d71\u7121\u6cd5\u555f\u52d5\u7684\u554f\u984c\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u8a2d\u8a08\u5341\uff1aHeartbeat \u2014 \u4e3b\u52d5\u559a\u9192\u6a5f\u5236\u8b93 Agent \u4e0d\u53ea\u88ab\u52d5\u56de\u61c9<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\u5927\u591a\u6578 AI \u52a9\u624b\u53ea\u80fd\u88ab\u52d5\u56de\u61c9\u4f7f\u7528\u8005\u8a0a\u606f\uff0cnanobot \u7684 Heartbeat \u6a5f\u5236\u8b93 Agent \u53ef\u4ee5\u4e3b\u52d5\u300c\u9192\u4f86\u300d\u6aa2\u67e5\u4efb\u52d9\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/github.com\/HKUDS\/nanobot\/blob\/main\/nanobot\/heartbeat\/service.py\"><code>nanobot\/heartbeat\/service.py<\/code><\/a> \u2014 \u5fc3\u8df3\u670d\u52d9\uff0c\u5b9a\u671f\u559a\u9192 Agent \u57f7\u884c HEARTBEAT.md \u4e2d\u7684\u4efb\u52d9<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><span><code class=\"hljs\">HEARTBEAT_PROMPT = \"\"\"Read HEARTBEAT.md in your workspace (if it exists).\nFollow any instructions or tasks listed there.\nIf nothing needs attention, reply with just: HEARTBEAT_OK\"\"\"\n\nclass HeartbeatService:\n    async def _tick(self) -&gt; None:\n        content = self._read_heartbeat_file()\n        if _is_heartbeat_empty(content):\n            return  # \u6c92\u4efb\u52d9\u5c31\u8df3\u904e\n        response = await self.on_heartbeat(HEARTBEAT_PROMPT)\n        if HEARTBEAT_OK_TOKEN in response.upper():\n            logger.info(\"Heartbeat: OK (no action needed)\")\n<\/code><\/span><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\">\u8a2d\u8a08\u5de7\u601d\uff1a<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n\n<li><strong>\u5148\u6aa2\u67e5\u6a94\u6848\u662f\u5426\u6709\u5be6\u8cea\u5167\u5bb9<\/strong>\uff1a<code>_is_heartbeat_empty<\/code> \u6703\u904e\u6ffe\u6389\u7a7a\u884c\u3001\u6a19\u984c\u3001HTML \u8a3b\u89e3\uff0c\u53ea\u6709\u771f\u6b63\u6709\u5f85\u8fa6\u4e8b\u9805\u6642\u624d\u559a\u9192 Agent\uff0c\u907f\u514d\u6d6a\u8cbb LLM token\u3002<\/li>\n\n\n<li><strong>HEARTBEAT_OK Token<\/strong>\uff1aAgent \u5224\u65b7\u6c92\u4e8b\u505a\u6642\u56de\u8986 <code>HEARTBEAT_OK<\/code>\uff0c\u7cfb\u7d71\u64da\u6b64\u6c7a\u5b9a\u662f\u5426\u8a18\u9304\u65e5\u8a8c\u3002<\/li>\n\n\n<li><strong>\u7d14 Markdown \u9a45\u52d5<\/strong>\uff1a\u4f7f\u7528\u8005\u53ea\u9700\u8981\u7de8\u8f2f <code>HEARTBEAT.md<\/code> \u5c31\u80fd\u65b0\u589e\u6216\u79fb\u9664\u9031\u671f\u6027\u4efb\u52d9\uff0c\u4e0d\u9700\u8981\u5beb\u4efb\u4f55\u7a0b\u5f0f\u78bc\u3002<\/li>\n\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">Prompt \u8a2d\u8a08\u89e3\u8b80<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">nanobot \u7684 prompt \u7cfb\u7d71\u63a1\u7528\u300cWorkspace-as-Prompt\u300d\u7684\u7406\u5ff5\u2014\u2014\u628a System Prompt \u62c6\u6210\u591a\u500b Markdown \u6a94\u6848\uff0c\u6bcf\u500b\u6a94\u6848\u8ca0\u8cac\u4e0d\u540c\u9762\u5411\u7684\u4eba\u683c\u548c\u884c\u70ba\u5b9a\u7fa9\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/github.com\/HKUDS\/nanobot\/blob\/main\/workspace\/SOUL.md\"><code>workspace\/SOUL.md<\/code><\/a> \u2014 Agent \u4eba\u683c\u8a2d\u5b9a\uff0c\u4f7f\u7528\u8005\u53ef\u4ee5\u81ea\u8a02 AI \u7684\u500b\u6027\u548c\u50f9\u503c\u89c0<\/p>\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\" aria-describedby=\"shcb-language-10\" data-shcb-language-name=\"PHP\" data-shcb-language-slug=\"php\"><span><code class=\"hljs language-php\"><span class=\"hljs-comment\"># Soul<\/span>\nI am nanobot \ud83d\udc08, a personal AI assistant.\n<span class=\"hljs-comment\">## Personality<\/span>\n- Helpful <span class=\"hljs-keyword\">and<\/span> friendly\n- Concise <span class=\"hljs-keyword\">and<\/span> to the point\n<span class=\"hljs-comment\">## Values<\/span>\n- Accuracy over speed\n- User privacy <span class=\"hljs-keyword\">and<\/span> safety\n- Transparency in actions\n<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-10\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">PHP<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">php<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre><\/div>\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/github.com\/HKUDS\/nanobot\/blob\/main\/workspace\/AGENTS.md\"><code>workspace\/AGENTS.md<\/code><\/a> \u2014 Agent \u884c\u70ba\u6307\u5f15\uff0c\u5b9a\u7fa9\u5de5\u5177\u4f7f\u7528\u898f\u7bc4\u548c\u8a18\u61b6\u7b56\u7565<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><a href=\"https:\/\/github.com\/HKUDS\/nanobot\/blob\/main\/workspace\/USER.md\"><code>workspace\/USER.md<\/code><\/a> \u2014 \u4f7f\u7528\u8005\u8cc7\u8a0a\u6a21\u677f\uff0cAgent \u6703\u6839\u64da\u9019\u4e9b\u8cc7\u8a0a\u500b\u6027\u5316\u56de\u61c9<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u9019\u500b\u8a2d\u8a08\u7684\u7cbe\u5999\u4e4b\u8655\u5728\u65bc\uff1a<strong>\u4f7f\u7528\u8005\u4e0d\u9700\u8981\u7406\u89e3 prompt engineering\uff0c\u53ea\u9700\u8981\u586b\u5beb\u4e00\u4efd\u300c\u500b\u4eba\u6a94\u6848\u300d<\/strong>\u3002<code>USER.md<\/code> \u6a21\u677f\u8a2d\u8a08\u4e86\u6642\u5340\u3001\u8a9e\u8a00\u504f\u597d\u3001\u6280\u8853\u6c34\u6e96\u3001\u5de5\u4f5c\u80cc\u666f\u7b49\u6b04\u4f4d\uff0cAgent \u6703\u81ea\u52d5\u5c07\u9019\u4e9b\u8cc7\u8a0a\u878d\u5165\u56de\u61c9\u4e2d\u3002\u800c <code>SOUL.md<\/code> \u8b93\u9032\u968e\u4f7f\u7528\u8005\u53ef\u4ee5\u5b8c\u5168\u91cd\u5851 Agent \u7684\u4eba\u683c\u3002<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\u8a2d\u8a08\u7406\u5ff5\u8403\u53d6<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li><strong>Message Bus \u89e3\u8026\u662f\u591a Channel \u7cfb\u7d71\u7684\u6839\u57fa<\/strong> \u2014 \u53ea\u8981\u7528\u4e00\u500b async Queue \u5c31\u80fd\u8b93 N \u500b Channel \u548c Agent \u4e4b\u9593\u5b8c\u5168\u89e3\u8026\u3002\u65b0\u589e\u4e00\u500b Channel \u4e0d\u9700\u8981\u6539\u52d5 Agent \u7684\u4efb\u4f55\u7a0b\u5f0f\u78bc\uff0c\u53cd\u4e4b\u4ea6\u7136\u3002\u9019\u500b\u6a21\u5f0f\u9069\u7528\u65bc\u4efb\u4f55\u9700\u8981\u591a\u8f38\u5165\u6e90\u7684\u7cfb\u7d71\u3002<\/li>\n\n\n<li><strong>Tool \u7cfb\u7d71 = \u62bd\u8c61\u57fa\u985e + Registry + \u81ea\u52d5\u9a57\u8b49<\/strong> \u2014 \u628a\u300cTool \u5b9a\u7fa9\u300d\uff08name\/description\/parameters\uff09\u548c\u300cTool \u57f7\u884c\u300d\uff08execute\uff09\u7d71\u4e00\u5728\u4e00\u500b\u62bd\u8c61\u985e\u5225\u4e2d\uff0cRegistry \u8ca0\u8cac\u67e5\u627e\u548c\u932f\u8aa4\u8655\u7406\u3002\u9019\u5957\u6a21\u5f0f\u8b93\u65b0\u589e\u5de5\u5177\u53ea\u9700\u8981\u5efa\u4e00\u500b\u65b0 class\uff0c\u4e0d\u7528\u6539\u4efb\u4f55\u5df2\u6709\u7a0b\u5f0f\u78bc\u3002<\/li>\n\n\n<li><strong>\u300c\u932f\u8aa4\u7576\u6210\u56de\u50b3\u503c\u300d\u6bd4\u62cb\u7570\u5e38\u66f4\u9069\u5408 Agent \u7cfb\u7d71<\/strong> \u2014 nanobot \u5728 Tool \u57f7\u884c\u548c LLM \u547c\u53eb\u4e2d\u90fd\u63a1\u7528\u300c\u932f\u8aa4\u56de\u50b3\u70ba\u5b57\u4e32\u300d\u800c\u975e\u62cb\u7570\u5e38\u7684\u7b56\u7565\u3002\u9019\u8b93 LLM \u80fd\u770b\u5230\u932f\u8aa4\u8a0a\u606f\u4e26\u5617\u8a66\u81ea\u6211\u4fee\u6b63\uff0c\u6bd4\u76f4\u63a5 crash \u66f4\u6709\u5f48\u6027\u3002<\/li>\n\n\n<li><strong>Workspace-as-Prompt \u8b93\u975e\u5de5\u7a0b\u5e2b\u4e5f\u80fd\u81ea\u8a02 Agent \u884c\u70ba<\/strong> \u2014 \u628a System Prompt \u62c6\u6210\u591a\u500b Markdown \u6a94\u6848\u653e\u5728 workspace \u4e2d\uff0c\u4f7f\u7528\u8005\u7de8\u8f2f\u6a94\u6848\u5c31\u80fd\u6539\u8b8a Agent \u7684\u884c\u70ba\uff0c\u4e0d\u9700\u8981\u6539\u7a0b\u5f0f\u78bc\u3002\u9019\u662f\u300c\u8a2d\u5b9a\u512a\u65bc\u7de8\u78bc\u300d\u539f\u5247\u5728 AI Agent \u9818\u57df\u7684\u6975\u81f4\u9ad4\u73fe\u3002<\/li>\n\n\n<li><strong>\u6f38\u9032\u5f0f\u8f09\u5165\u662f LLM \u8cc7\u6e90\u7ba1\u7406\u7684\u95dc\u9375\u6a21\u5f0f<\/strong> \u2014 Skills \u7684\u4e09\u5c64\u8f09\u5165\u7b56\u7565\uff08Metadata \u2192 SKILL.md \u2192 Resources\uff09\u89e3\u6c7a\u4e86\u300c\u80fd\u529b\u591a\u4f46 context window \u6709\u9650\u300d\u7684\u77db\u76fe\u3002\u9019\u500b\u6a21\u5f0f\u53ef\u4ee5\u63a8\u5ee3\u5230\u4efb\u4f55\u9700\u8981\u5728\u6709\u9650 context \u4e2d\u7ba1\u7406\u5927\u91cf\u77e5\u8b58\u7684\u5834\u666f\u3002<\/li>\n\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">\u5ef6\u4f38\u601d\u8003<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">nanobot \u7684\u67b6\u69cb\u96d6\u7136\u53ea\u6709 3,400 \u884c\uff0c\u4f46\u5b83\u5c55\u793a\u4e86\u4e00\u500b\u300c\u5b8c\u6574\u300dAI Agent \u6846\u67b6\u9700\u8981\u7684\u6240\u6709\u6838\u5fc3\u7d44\u4ef6\u3002\u5982\u679c\u4f60\u6b63\u5728\u5efa\u69cb\u81ea\u5df1\u7684 Agent \u7cfb\u7d71\uff0c\u53ef\u4ee5\u8003\u616e\u4ee5\u4e0b\u61c9\u7528\uff1a<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n\n<li><strong>\u5148\u5efa Message Bus\uff0c\u518d\u5efa\u5176\u4ed6\u4e00\u5207<\/strong>\u3002\u5373\u4f7f\u4f60\u4e00\u958b\u59cb\u53ea\u6709\u4e00\u500b Channel\uff08\u6bd4\u5982 CLI\uff09\uff0cBus \u7684\u5b58\u5728\u4e5f\u8b93\u672a\u4f86\u64f4\u5c55\u8b8a\u5f97\u96f6\u6210\u672c\u3002<\/li>\n\n\n<li><strong>Tool Registry \u6a21\u5f0f\u53ef\u4ee5\u76f4\u63a5\u8907\u88fd<\/strong>\u3002\u62bd\u8c61\u57fa\u985e + dict registry + \u81ea\u52d5 JSON Schema \u9a57\u8b49\uff0c\u9019\u5957\u6a21\u5f0f\u4e0d\u5230 100 \u884c\u7a0b\u5f0f\u78bc\u5c31\u80fd\u5be6\u73fe\uff0c\u537b\u80fd\u652f\u6490\u6574\u500b Tool \u751f\u614b\u3002<\/li>\n\n\n<li><strong>Heartbeat \u6a5f\u5236\u503c\u5f97\u52a0\u5165\u4efb\u4f55\u9577\u99d0\u578b Agent<\/strong>\u3002\u8b93 Agent \u6709\u80fd\u529b\u4e3b\u52d5\u6aa2\u67e5\u5f85\u8fa6\u4e8b\u9805\u3001\u767c\u51fa\u63d0\u9192\uff0c\u662f\u5f9e\u300c\u5de5\u5177\u300d\u9032\u5316\u5230\u300c\u52a9\u624b\u300d\u7684\u95dc\u9375\u4e00\u6b65\u3002<\/li>\n\n\n<li><strong>\u7528 Markdown \u6a94\u6848\u4f5c\u70ba\u8a2d\u5b9a\u4ecb\u9762<\/strong>\u3002\u6bd4\u8d77 JSON\/YAML \u8a2d\u5b9a\u6a94\uff0cMarkdown \u6a94\u6848\u5c0d\u4f7f\u7528\u8005\u66f4\u53cb\u597d\uff0c\u800c\u4e14\u53ef\u4ee5\u5305\u542b\u5bcc\u6587\u672c\u8aaa\u660e\uff0c\u8b93\u300c\u8a2d\u5b9a\u300d\u672c\u8eab\u6210\u70ba\u4e00\u4efd\u6307\u5357\u3002<\/li>\n\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">Vibe Coding\uff1a\u628a\u89c0\u5ff5\u8b8a\u6210\u7a0b\u5f0f\u78bc<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\u4ee5\u4e0b\u662f\u4f60\u53ef\u4ee5\u76f4\u63a5\u7d66 AI \u7684 prompt \u6307\u4ee4\uff0c\u5c07\u672c\u6587\u4ecb\u7d39\u7684\u8a2d\u8a08\u89c0\u5ff5\u61c9\u7528\u5230\u4f60\u7684\u5c08\u6848\u4e2d\uff1a<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Message Bus \u89e3\u8026\u901a\u8a0a\u5c64<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u5834\u666f<\/strong>\uff1a\u4f60\u6b63\u5728\u5efa\u69cb\u4e00\u500b\u9700\u8981\u652f\u63f4\u591a\u500b\u8f38\u5165\u4f86\u6e90\u7684\u7cfb\u7d71\uff08\u4f8b\u5982\u540c\u6642\u652f\u63f4 API\u3001WebSocket\u3001CLI\uff09\uff0c\u800c\u4e14\u5e0c\u671b\u672a\u4f86\u80fd\u8f15\u9b06\u65b0\u589e\u901a\u9053\u800c\u4e0d\u6539\u52d5\u6838\u5fc3\u908f\u8f2f\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u7d66 AI \u7684\u6307\u4ee4<\/strong>\uff1a<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">\u8acb\u5e6b\u6211\u5728\u5c08\u6848\u4e2d\u5be6\u4f5c\u4e00\u500b Message Bus \u6a21\u5f0f\uff0c\u7528 Python asyncio.Queue \u5be6\u73fe\u96d9\u5411\u901a\u8a0a\u3002\u9700\u8981\uff1a(1) \u4e00\u500b InboundMessage dataclass \u5305\u542b channel\u3001sender_id\u3001content \u6b04\u4f4d\uff0c(2) \u4e00\u500b MessageBus \u985e\u5225\u5305\u542b inbound \u548c outbound \u5169\u500b asyncio.Queue\uff0coutbound \u652f\u63f4 Pub\/Sub \u8a02\u95b1\u6a5f\u5236\u8b93\u4e0d\u540c channel \u53ea\u63a5\u6536\u5c6c\u65bc\u81ea\u5df1\u7684\u8a0a\u606f\uff0c(3) Channel \u62bd\u8c61\u57fa\u985e\u5b9a\u7fa9 start\/stop\/send \u4ecb\u9762\u3002\u76ee\u6a19\u662f\u8b93 Channel \u5c64\u548c\u6838\u5fc3\u8655\u7406\u908f\u8f2f\u5b8c\u5168\u89e3\u8026\uff0c\u65b0\u589e Channel \u4e0d\u9700\u8981\u6539\u52d5\u4efb\u4f55\u5df2\u6709\u7a0b\u5f0f\u78bc\u3002\u8acb\u53c3\u8003 nanobot \u7684 Message Bus \u8a2d\u8a08\u3002<\/p>\n<\/blockquote>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u6548\u679c<\/strong>\uff1aAI \u6703\u7522\u51fa\u4e00\u7d44\u5b8c\u6574\u7684 Message Bus \u57fa\u790e\u8a2d\u65bd\u7a0b\u5f0f\u78bc\uff0c\u5305\u542b\u4e8b\u4ef6\u5b9a\u7fa9\u3001Bus \u5be6\u4f5c\u3001Channel \u62bd\u8c61\u57fa\u985e\uff0c\u4ee5\u53ca\u4e00\u500b\u7bc4\u4f8b Channel \u5be6\u4f5c\u5c55\u793a\u5982\u4f55\u4e32\u63a5\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Tool Registry \u52d5\u614b\u8a3b\u518a\u8207\u81ea\u52d5\u9a57\u8b49<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u5834\u666f<\/strong>\uff1a\u4f60\u6b63\u5728\u70ba AI Agent \u5efa\u69cb\u5de5\u5177\u7cfb\u7d71\uff0c\u5e0c\u671b\u65b0\u589e\u5de5\u5177\u6642\u53ea\u9700\u8981\u5efa\u4e00\u500b\u65b0 class\uff0c\u4e0d\u7528\u6539\u52d5\u5176\u4ed6\u7a0b\u5f0f\u78bc\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u7d66 AI \u7684\u6307\u4ee4<\/strong>\uff1a<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">\u8acb\u5e6b\u6211\u5be6\u4f5c\u4e00\u500b Tool Registry \u7cfb\u7d71\uff0c\u53c3\u8003 nanobot \u7684\u300c\u62bd\u8c61\u57fa\u985e + Registry + \u81ea\u52d5\u9a57\u8b49\u300d\u6a21\u5f0f\u3002\u9700\u8981\uff1a(1) Tool \u62bd\u8c61\u57fa\u985e\uff0c\u5b9a\u7fa9 name\u3001description\u3001parameters\uff08JSON Schema \u683c\u5f0f\uff09\u5c6c\u6027\u548c async execute \u65b9\u6cd5\uff0c\u57fa\u985e\u5167\u5efa validate_params \u65b9\u6cd5\u6839\u64da JSON Schema \u81ea\u52d5\u9a57\u8b49 LLM \u56de\u50b3\u7684\u53c3\u6578\uff0c\u4ee5\u53ca to_schema \u65b9\u6cd5\u8f38\u51fa OpenAI function calling \u683c\u5f0f\uff0c(2) ToolRegistry \u985e\u5225\u7528 dict \u7ba1\u7406\u5de5\u5177\uff0cexecute \u65b9\u6cd5\u7d71\u4e00\u8655\u7406\u300c\u67e5\u627e \u2192 \u9a57\u8b49 \u2192 \u57f7\u884c \u2192 \u932f\u8aa4\u8655\u7406\u300d\uff0c\u932f\u8aa4\u56de\u50b3\u5b57\u4e32\u800c\u975e\u62cb\u7570\u5e38\u8b93 LLM \u80fd\u81ea\u6211\u4fee\u6b63\uff0c(3) \u4e00\u500b\u5177\u9ad4 Tool \u5be6\u4f5c\u4f5c\u70ba\u7bc4\u4f8b\u3002<\/p>\n<\/blockquote>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u6548\u679c<\/strong>\uff1aAI \u6703\u7522\u51fa\u4e00\u5957\u53ef\u76f4\u63a5\u4f7f\u7528\u7684 Tool \u7cfb\u7d71\uff0c\u5305\u542b\u57fa\u985e\u3001Registry\u3001\u7bc4\u4f8b\u5de5\u5177\u3002\u65b0\u589e\u5de5\u5177\u53ea\u9700\u7e7c\u627f\u57fa\u985e\u4e26 register\uff0c\u5b8c\u5168\u7b26\u5408\u958b\u653e\u5c01\u9589\u539f\u5247\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\u932f\u8aa4\u56de\u50b3\u5b57\u4e32\u800c\u975e\u62cb\u7570\u5e38<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u5834\u666f<\/strong>\uff1a\u4f60\u5728 Code Review \u4e00\u500b AI Agent \u5c08\u6848\uff0c\u767c\u73fe Tool \u57f7\u884c\u932f\u8aa4\u6642\u76f4\u63a5\u62cb\u7570\u5e38\u5c0e\u81f4 Agent \u4e2d\u65b7\uff0c\u60f3\u6539\u6210\u66f4\u6709\u5f48\u6027\u7684\u932f\u8aa4\u8655\u7406\u7b56\u7565\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u7d66 AI \u7684\u6307\u4ee4<\/strong>\uff1a<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">\u8acb\u91cd\u69cb\u6211\u5c08\u6848\u4e2d\u7684 Tool \u57f7\u884c\u932f\u8aa4\u8655\u7406\u6a5f\u5236\uff0c\u63a1\u7528 nanobot \u7684\u300c\u932f\u8aa4\u7576\u6210\u56de\u50b3\u503c\u300d\u7b56\u7565\u3002\u76ee\u524d Tool \u57f7\u884c\u5931\u6557\u6642\u6703\u62cb\u7570\u5e38\u5c0e\u81f4\u6574\u500b Agent Loop \u4e2d\u65b7\u3002\u8acb\u6539\u6210\uff1a(1) Tool \u7684 execute \u65b9\u6cd5\u5728\u5167\u90e8 catch \u6240\u6709\u7570\u5e38\uff0c\u56de\u50b3\u683c\u5f0f\u5316\u7684\u932f\u8aa4\u5b57\u4e32\u5982 &#8220;Error: [\u932f\u8aa4\u63cf\u8ff0]&#8221;\uff0c(2) LLM Provider \u547c\u53eb\u5931\u6557\u6642\u4e5f\u56de\u50b3\u5305\u542b\u932f\u8aa4\u8a0a\u606f\u7684 LLMResponse \u7269\u4ef6\u800c\u975e\u62cb\u7570\u5e38\uff0c(3) \u78ba\u4fdd Agent Loop \u4e0d\u6703\u56e0\u70ba\u55ae\u4e00 Tool \u5931\u6557\u5c31\u505c\u6b62\uff0c\u800c\u662f\u8b93 LLM \u770b\u5230\u932f\u8aa4\u8a0a\u606f\u5f8c\u80fd\u5617\u8a66\u66ff\u4ee3\u65b9\u6848\u6216\u81ea\u6211\u4fee\u6b63\u3002\u9019\u500b\u6a21\u5f0f\u7684\u6838\u5fc3\u7406\u5ff5\u662f\uff1a\u5728 Agent \u7cfb\u7d71\u4e2d\uff0cLLM \u672c\u8eab\u5c31\u662f\u6700\u597d\u7684\u932f\u8aa4\u8655\u7406\u5668\u3002<\/p>\n<\/blockquote>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u6548\u679c<\/strong>\uff1aAI \u6703\u9010\u4e00\u6aa2\u67e5 Tool \u548c Provider \u7684\u932f\u8aa4\u8655\u7406\u908f\u8f2f\uff0c\u5c07 raise Exception \u6539\u70ba return error string\uff0c\u4e26\u78ba\u4fdd Agent Loop \u7684\u5bb9\u932f\u6027\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">System Prompt \u6a21\u7d44\u5316\u7d44\u88dd\uff08Workspace-as-Prompt\uff09<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u5834\u666f<\/strong>\uff1a\u4f60\u7684 Agent \u7684 System Prompt \u8d8a\u4f86\u8d8a\u9577\u4e14\u96e3\u4ee5\u7dad\u8b77\uff0c\u60f3\u628a\u5b83\u62c6\u6210\u591a\u500b\u53ef\u7ba1\u7406\u7684\u6a21\u7d44\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u7d66 AI \u7684\u6307\u4ee4<\/strong>\uff1a<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">\u8acb\u5e6b\u6211\u91cd\u69cb Agent \u7684 System Prompt \u7cfb\u7d71\uff0c\u63a1\u7528 nanobot \u7684\u300cWorkspace-as-Prompt\u300d\u6a21\u5f0f\u2014\u2014\u628a System Prompt \u62c6\u6210\u591a\u500b Markdown \u6a94\u6848\u52d5\u614b\u7d44\u88dd\u3002\u9700\u8981\u4e00\u500b ContextBuilder \u985e\u5225\uff0c\u5f9e\u6307\u5b9a\u76ee\u9304\u8b80\u53d6\u4ee5\u4e0b\u6a94\u6848\u4f86\u7d44\u88dd System Prompt\uff1a(1) IDENTITY.md \u2014 \u6838\u5fc3\u8eab\u4efd\u8207\u80fd\u529b\u63cf\u8ff0\uff0c(2) RULES.md \u2014 \u884c\u70ba\u898f\u7bc4\u8207\u9650\u5236\uff0c(3) USER.md \u2014 \u4f7f\u7528\u8005\u504f\u597d\u8207\u80cc\u666f\u8cc7\u8a0a\uff0c(4) MEMORY.md \u2014 \u9577\u671f\u8a18\u61b6\u3002\u7d44\u88dd\u6642\u7528 &#8220;&#8212;&#8221; \u5206\u9694\u5404\u5340\u584a\uff0c\u6a94\u6848\u4e0d\u5b58\u5728\u5c31\u8df3\u904e\u3002\u9019\u6a23\u4f7f\u7528\u8005\u7de8\u8f2f Markdown \u6a94\u6848\u5c31\u80fd\u81ea\u8a02 Agent \u884c\u70ba\uff0c\u4e0d\u9700\u8981\u6539\u7a0b\u5f0f\u78bc\u3002<\/p>\n<\/blockquote>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u6548\u679c<\/strong>\uff1aAI \u6703\u5efa\u7acb\u4e00\u500b ContextBuilder \u548c\u5c0d\u61c9\u7684 workspace \u76ee\u9304\u7d50\u69cb\uff0c\u5305\u542b\u5404\u6a21\u677f\u6a94\u6848\u548c\u8b80\u53d6\u908f\u8f2f\uff0c\u8b93 System Prompt \u8b8a\u6210\u53ef\u7dad\u8b77\u7684\u6a21\u7d44\u5316\u7d50\u69cb\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Skills \u6f38\u9032\u5f0f\u8f09\u5165\u7bc0\u7701 Context Window<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u5834\u666f<\/strong>\uff1a\u4f60\u7684 Agent \u652f\u63f4\u8d8a\u4f86\u8d8a\u591a\u529f\u80fd\uff0c\u4f46\u628a\u6240\u6709 Skill \u8aaa\u660e\u90fd\u585e\u9032 System Prompt \u6703\u4f54\u7528\u592a\u591a token\uff0c\u5f71\u97ff\u5be6\u969b\u5c0d\u8a71\u54c1\u8cea\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u7d66 AI \u7684\u6307\u4ee4<\/strong>\uff1a<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">\u8acb\u5e6b\u6211\u5be6\u4f5c\u4e00\u500b Skills \u6f38\u9032\u5f0f\u8f09\u5165\u7cfb\u7d71\uff0c\u53c3\u8003 nanobot \u7684\u4e09\u5c64 Progressive Disclosure \u8a2d\u8a08\u3002\u4e09\u5c64\u7b56\u7565\u70ba\uff1aL1 Metadata\uff08\u6c38\u9060\u8f09\u5165\uff0c\u6bcf\u500b Skill \u7d04 100 tokens\uff0c\u53ea\u542b\u540d\u7a31\u548c\u63cf\u8ff0\u6458\u8981\uff09\uff0cL2 SKILL.md\uff08Agent \u5224\u65b7\u9700\u8981\u6642\u624d\u8f09\u5165\uff0c\u5305\u542b\u5b8c\u6574\u64cd\u4f5c\u6307\u5f15\uff09\uff0cL3 Resources\uff08\u5177\u9ad4\u64cd\u4f5c\u6642\u624d\u8f09\u5165\u7684\u8173\u672c\u548c\u53c3\u8003\u8cc7\u6599\uff09\u3002\u9700\u8981\uff1a(1) \u6bcf\u500b Skill \u76ee\u9304\u5305\u542b metadata.json\uff08\u540d\u7a31\u3001\u63cf\u8ff0\u3001\u4f9d\u8cf4\u6aa2\u67e5\uff09\u548c SKILL.md\uff0c(2) SkillsLoader \u985e\u5225\u555f\u52d5\u6642\u6383\u63cf\u6240\u6709 Skill \u76ee\u9304\uff0c\u6aa2\u67e5\u4f9d\u8cf4\u662f\u5426\u6eff\u8db3\uff08\u5982\u7279\u5b9a CLI \u5de5\u5177\u662f\u5426\u5b89\u88dd\uff09\uff0c(3) build_skills_summary \u65b9\u6cd5\u7522\u51fa L1 \u6458\u8981\u5d4c\u5165 System Prompt\uff0c(4) Agent \u9700\u8981\u67d0\u500b Skill \u6642\u7528 read_file \u5de5\u5177\u8b80\u53d6 L2 \u5167\u5bb9\u3002<\/p>\n<\/blockquote>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u6548\u679c<\/strong>\uff1aAI \u6703\u5efa\u7acb\u5b8c\u6574\u7684 Skills \u76ee\u9304\u7d50\u69cb\u3001Loader \u908f\u8f2f\u548c\u4f9d\u8cf4\u6aa2\u67e5\u6a5f\u5236\uff0c\u8b93\u4f60\u7684 Agent \u5728\u6709\u9650\u7684 context window \u4e2d\u7ba1\u7406\u5927\u91cf\u529f\u80fd\u800c\u4e0d\u6d6a\u8cbb token\u3002<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Heartbeat \u4e3b\u52d5\u559a\u9192\u6a5f\u5236<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u5834\u666f<\/strong>\uff1a\u4f60\u6709\u4e00\u500b\u9577\u99d0\u578b AI Agent\uff0c\u76ee\u524d\u53ea\u80fd\u88ab\u52d5\u56de\u61c9\u4f7f\u7528\u8005\u8a0a\u606f\uff0c\u60f3\u8b93\u5b83\u80fd\u5b9a\u671f\u4e3b\u52d5\u6aa2\u67e5\u5f85\u8fa6\u4e8b\u9805\u4e26\u57f7\u884c\u4efb\u52d9\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u7d66 AI \u7684\u6307\u4ee4<\/strong>\uff1a<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">\u8acb\u5e6b\u6211\u70ba\u73fe\u6709\u7684 Agent \u52a0\u5165 Heartbeat \u4e3b\u52d5\u559a\u9192\u6a5f\u5236\uff0c\u53c3\u8003 nanobot \u7684\u8a2d\u8a08\u3002\u9700\u8981\uff1a(1) HeartbeatService \u985e\u5225\uff0c\u7528 asyncio \u5b9a\u6642\u5668\u6309\u8a2d\u5b9a\u9593\u9694\u57f7\u884c\u5fc3\u8df3\uff0c(2) \u6bcf\u6b21\u5fc3\u8df3\u5148\u8b80\u53d6 HEARTBEAT.md \u6a94\u6848\uff0c\u904e\u6ffe\u7a7a\u884c\u548c\u7d14\u6a19\u984c\uff0c\u53ea\u6709\u5b58\u5728\u5be6\u8cea\u5f85\u8fa6\u4e8b\u9805\u6642\u624d\u559a\u9192 Agent\uff0c(3) \u559a\u9192\u6642\u767c\u9001\u56fa\u5b9a prompt \u8acb Agent \u8b80\u53d6\u4e26\u57f7\u884c HEARTBEAT.md \u4e2d\u7684\u4efb\u52d9\uff0c(4) Agent \u5224\u65b7\u6c92\u4e8b\u505a\u6642\u56de\u8986\u7279\u5b9a token\uff08\u5982 HEARTBEAT_OK\uff09\uff0c\u7cfb\u7d71\u64da\u6b64\u8a18\u9304\u65e5\u8a8c\u3002\u95dc\u9375\u662f\u5148\u6aa2\u67e5\u518d\u559a\u9192\uff0c\u907f\u514d\u7121\u8b02\u7684 LLM \u547c\u53eb\u6d6a\u8cbb token\u3002<\/p>\n<\/blockquote>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\u6548\u679c<\/strong>\uff1aAI \u6703\u7522\u51fa\u4e00\u500b\u5b8c\u6574\u7684 Heartbeat \u670d\u52d9\uff0c\u5305\u542b\u5b9a\u6642\u5668\u3001\u6a94\u6848\u6aa2\u67e5\u908f\u8f2f\u3001Agent \u559a\u9192\u6d41\u7a0b\uff0c\u8b93\u4f60\u7684 Agent \u5f9e\u88ab\u52d5\u5de5\u5177\u9032\u5316\u70ba\u4e3b\u52d5\u52a9\u624b\u3002<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\u5ef6\u4f38\u95b1\u8b80<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n\n<li><a href=\"https:\/\/github.com\/HKUDS\/nanobot\">nanobot GitHub Repository<\/a> \u2014 \u5c08\u6848\u539f\u59cb\u78bc\u8207\u5b8c\u6574\u6587\u4ef6\uff0c\u5305\u542b\u5b89\u88dd\u6307\u5357\u3001\u67b6\u69cb\u8aaa\u660e\uff0c\u4ee5\u53ca\u6240\u6709\u672c\u6587\u89e3\u8b80\u7684\u8a2d\u8a08\u5be6\u4f5c<\/li>\n\n\n<li><a href=\"https:\/\/www.anthropic.com\/research\/building-effective-agents\">Building Effective AI Agents \u2014 Anthropic<\/a> \u2014 Anthropic \u5b98\u65b9\u7684 Agent \u8a2d\u8a08\u6307\u5357\uff0c\u6db5\u84cb Workflow vs Agent \u7684\u9078\u64c7\u3001\u5de5\u5177\u4f7f\u7528\u6a21\u5f0f\u3001\u591a\u4ee3\u7406\u67b6\u69cb\u7b49\uff0c\u662f\u7406\u89e3 AI Agent \u8a2d\u8a08\u54f2\u5b78\u7684\u5fc5\u8b80\u6587\u4ef6<\/li>\n\n\n<li><a href=\"https:\/\/til.simonwillison.net\/llms\/python-react-pattern\">A Simple Python Implementation of the ReAct Pattern for LLMs \u2014 Simon Willison<\/a> \u2014 \u7528\u4e0d\u5230 100 \u884c Python \u5be6\u4f5c ReAct \u6a21\u5f0f\uff0c\u6e05\u695a\u5c55\u793a\u4e86 nanobot Agent Loop \u80cc\u5f8c\u7684\u6838\u5fc3\u6982\u5ff5<\/li>\n\n\n<li><a href=\"https:\/\/williamzujkowski.github.io\/posts\/from-150k-to-2k-tokens-how-progressive-context-loading-revolutionizes-llm-development-workflows\/\">From 150K to 2K Tokens: How Progressive Context Loading Revolutionizes LLM Development Workflows<\/a> \u2014 \u6df1\u5165\u89e3\u6790\u6f38\u9032\u5f0f Context \u8f09\u5165\u5982\u4f55\u5c07 token \u4f7f\u7528\u91cf\u964d\u4f4e 98%\uff0c\u8207 nanobot \u7684 Skills \u4e09\u5c64\u8f09\u5165\u7b56\u7565\u7406\u5ff5\u76f8\u540c<\/li>\n\n\n<li><a href=\"https:\/\/www.cosmicpython.com\/book\/chapter<em>08<\/em>events<em>and<\/em>message_bus.html&#8221;>Events and the Message Bus \u2014 Cosmic Python<\/a> \u2014 \u300aArchitecture Patterns with Python\u300b\u66f8\u4e2d\u95dc\u65bc Message Bus \u7684\u7ae0\u7bc0\uff0c\u5f9e\u9818\u57df\u9a45\u52d5\u8a2d\u8a08\u89d2\u5ea6\u89e3\u91cb\u70ba\u4f55 Message Bus \u662f\u89e3\u8026\u7cfb\u7d71\u5143\u4ef6\u7684\u95dc\u9375\u6a21\u5f0f<\/li>\n\n\n<li><a href=\"https:\/\/news.ycombinator.com\/item?id=46851464\">Nanobot: Ultra-Lightweight Personal AI Assistant \u2014 Hacker News \u8a0e\u8ad6<\/a> \u2014 \u793e\u7fa4\u5c0d nanobot \u67b6\u69cb\u8a2d\u8a08\u7684\u8a0e\u8ad6\uff0c\u5305\u542b\u8207\u5176\u4ed6 Agent \u6846\u67b6\u7684\u6bd4\u8f03\u89c0\u9ede<\/li>\n\n<\/ul>\n\n\n<div class=\"wp-like-post__wrapper\" style=\"\"><button type=\"button\" class=\"wp-like-post__button \" style=\"height: 30px; color: #000000;\" data-post-id=\"693\" data-total-likes=\"0\" data-likes-from-user=\"0\"><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" fill=\"none\" viewBox=\"0 0 24 24\" stroke-width=\"1.5\" stroke=\"currentColor\" width=\"30\" height=\"30\"><path stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M6.633 10.5c.806 0 1.533-.446 2.031-1.08a9.041 9.041 0 012.861-2.4c.723-.384 1.35-.956 1.653-1.715a4.498 4.498 0 00.322-1.672V3a.75.75 0 01.75-.75A2.25 2.25 0 0116.5 4.5c0 1.152-.26 2.243-.723 3.218-.266.558.107 1.282.725 1.282h3.126c1.026 0 1.945.694 2.054 1.715.045.422.068.85.068 1.285a11.95 11.95 0 01-2.649 7.521c-.388.482-.987.729-1.605.729H13.48c-.483 0-.964-.078-1.423-.23l-3.114-1.04a4.501 4.501 0 00-1.423-.23H5.904M14.25 9h2.25M5.904 18.75c.083.205.173.405.27.602.197.4-.078.898-.523.898h-.908c-.889 0-1.713-.518-1.972-1.368a12 12 0 01-.521-3.507c0-1.553.295-3.036.831-4.398C3.387 10.203 4.167 9.75 5 9.75h1.053c.472 0 .745.556.5.96a8.958 8.958 0 00-1.302 4.665c0 1.194.232 2.333.654 3.375z\" \/><\/svg><\/button><div class=\"wp-like-post__count\"\">0<\/div><\/div>","protected":false},"excerpt":{"rendered":"<p>nanobot \u662f\u9999\u6e2f\u5927\u5b78 HKUDS \u5718\u968a\u958b\u6e90\u7684\u8d85\u8f15\u91cf\u7d1a\u500b\u4eba AI \u52a9\u624b\uff0c\u5ba3\u7a31\u53ea\u7528\u7d04 3,400 \u884c\u6838\u5fc3\u7a0b\u5f0f [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"rolpb_likes":0,"footnotes":""},"categories":[555],"tags":[430,611,613,240,612,614],"class_list":["post-693","post","type-post","status-publish","format-standard","hentry","category-ai-agent-github","tag-ai-agent","tag-message-bus","tag-prompt-","tag-python","tag-tool-registry","tag-614"],"blocksy_meta":{"styles_descriptor":{"styles":{"desktop":"","tablet":"","mobile":""},"google_fonts":[],"version":7}},"_links":{"self":[{"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/posts\/693","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/comments?post=693"}],"version-history":[{"count":0,"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/posts\/693\/revisions"}],"wp:attachment":[{"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/media?parent=693"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/categories?post=693"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.itsmygo.uk\/wordpress\/wp-json\/wp\/v2\/tags?post=693"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}