logo
0
0
WeChat Login
docs(readme): 更新 NPC 任务指南

🦞 带你云原生养小龙虾

我是 没猫饼,今天带你云原生养小龙虾!

CoPaw 是一个用于构建、运行和编排 AI Agent 的通用框架,支持对话、工具调用与多模型接入。本项目提供了一键部署到云原生环境的完整解决方案。

项目地址https://cnb.cool/Bring/AGI/CoPaw

文档地址https://copaw.agentscope.io/docs/intro


🚀 一、注册组织,Fork 项目,一键启动小龙虾

先来体验一下!通过 CNB 的预览模式,点击就能启动你的小龙虾:

  1. 注册 CNB 账号 — 前往 CNB 注册
  2. 新建组织创建组织 ( 云原生开发需要运行在自己的组织里 )
  3. Fork 本项目 — 点击 CoPaw 项目页面右上角的 Fork 按钮,将项目 Fork 到先前创建的组织下
  4. 一键启动 — 进入你 Fork 后的仓库页面,点击 「替我自由」 按钮

系统会自动帮你完成:

  • 构建并启动容器
  • 配置反向代理服务
  • 启动 CoPaw 服务

无需手动配置环境,开箱即用,爽就完事了 👍

💡 「替我自由」按钮由 CNB 平台提供,仅在 Fork 后的仓库中可见


🛠️ 二、怎么复刻第一部分那个云原生 CoPaw

如果你不想只停留在 Fork + 一键启动,而是想自己复刻一个一模一样的云原生 CoPaw,核心思路其实很简单:把这个仓库里让 CoPaw 能在 CNB 上跑起来的那几样东西,按原样搬到你自己的仓库里。

你真正需要复刻的,主要就是这 4 部分:

  1. 应用本体 — 也就是 CoPaw 的代码、配置和依赖
  2. 容器环境Dockerfile,决定镜像怎么构建
  3. 云原生流程.cnb.yml,决定 CNB 怎么构建、启动、暴露服务
  4. 启动入口start.sh 或等价启动命令,决定容器启动后真正跑什么

可以按下面这个顺序来做:

  1. 在 CNB 新建一个空仓库 然后把第一部分里这个仓库的源码拷过去,最省事的方式就是直接参考本项目目录结构来准备你的仓库内容。

  2. 先复刻运行环境 优先把 Dockerfile 复刻过去。它定义了 Python 版本、系统依赖、安装步骤,以及 CoPaw 运行所需的基础环境。

  3. 再复刻 CNB 流水线配置.cnb.yml 一起带过去。这个文件决定了仓库在 CNB 上如何构建、如何启动,以及服务怎么暴露出来。

  4. 确认启动命令一致start.sh 或对应启动命令一起复刻,保证容器启动后拉起的就是 CoPaw,而不是只构建成功但没有真正提供服务。

  5. 补齐 CoPaw 配置 如果你改了项目结构、端口、模型配置或环境变量,记得同步调整配置文件;否则虽然“长得像”,但不一定能和第一部分那只小龙虾一样正常工作。

  6. 推送代码,验证部署结果 推送后让 CNB 自动构建并启动,最后检查两件事:

    • 服务是否成功启动
    • 页面或接口行为是否和第一部分的一键启动版本一致

一句话总结:不是重新发明一个云原生 CoPaw,而是把这个仓库里“能在 CNB 上跑起来”的那套最小闭环完整复刻到你自己的仓库里。

详细代码可以直接参考本项目源码;如果你想继续改 NPC、模型或技能,再结合 CoPaw 文档 往下扩展即可。


🎯 三、任务挑战 — 把小龙虾做成 NPC!

小龙虾跑起来了,接下来我们要让它更像一个 NPC(Non-Player Character)!跟着我一起完成任务,把小龙虾变成一个有灵魂的 NPC 吧。

这一部分的任务很简单:

  1. 先定义一个 NPC 角色:给这只小龙虾补上名字、人设和提示词
  2. 再把它接进 CNB 的 NPC 事件体系:让它可以在 Issue、PR 和评论场景里被 @ 到后开始工作
  3. 最后补齐 CoPaw 的能力配置:把技能、工具调用和执行逻辑接好,让它真的能完成任务

平台侧的 NPC 事件和工作模式由 CNB 提供,CoPaw 负责 NPC 背后的智能体能力。

具体怎么接入 NPC 事件、怎么配置角色和工作模式,可以直接看 CNB 官方文档:


📚 更多资源


🦞 一起养小龙虾吧!

欢迎 Fork、Star、提 Issue、提 PR,让我们一起把小龙虾养得又大又肥!

没猫饼 · 带你云原生养小龙虾 🦞

About

No description, topics, or website provided.