中文
快速开始
云端版

云端版快速开始

5 分钟内让 Agent 访问你的数据。

Step 1: 创建账号

访问 puppyone.ai (opens in a new tab) 注册账号。

Step 2: 创建 Project

  1. 登录后，点击 New Project
  2. 输入名称（如「产品知识库」）
  3. 点击 Create

Project 是你的顶层容器，所有数据以 Content Node 树（文件夹、JSON、Markdown、文件）的形式组织在其中。

Step 3: 导入数据

创建好 Project 后，有多种方式将数据导入。

方式一：上传文件

  1. 在 Dashboard 中点击 Import → Upload Files
  2. 拖拽或选择文件（PDF、Word、Excel 等）
  3. 等待处理完成，文件会自动转换为 Content Node

方式二：连接 Notion

通过 Dashboard：

  1. 点击 Import → Notion
  2. 完成 OAuth 授权
  3. 选择要导入的页面
  4. 点击 Import

或者通过 CLI：

puppyone sync auth notion
puppyone conn add notion https://notion.so/your-database-id --folder /docs

方式三：手动创建

通过 CLI 直接创建内容节点：

puppyone fs mkdir /products
puppyone fs touch -t json /products/widget.json
puppyone fs write /products/widget.json -d '{"name": "Widget Pro", "price": 99.99}'

也可以在 Dashboard 的编辑器中手动创建和编辑 JSON / Markdown 内容。

Step 4: 连接 Agent

最快的方式是通过 MCP 协议。先在 Dashboard 或 CLI 中创建一个 MCP 端点：

puppyone conn add mcp "My Data"

创建后会返回 MCP Server URL（格式为 https://api.puppyone.ai/api/v1/mcp/server/sk_live_xxx）。

以 Cursor 为例，在项目根目录创建 .cursor/mcp.json：

{
  "mcpServers": {
    "puppyone": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.puppyone.ai/api/v1/mcp/server/sk_live_xxx"]
    }
  }
}

将 sk_live_xxx 替换为你的实际 API Key，重启 Cursor 即可。

其他 Agent 的接入方式请参考分发文档——包括 Claude Desktop、Claude Code（文件同步）、REST API 等。

Step 5: 测试

在 Cursor 或 Claude Desktop 中问：

"帮我查询一下产品数据"

如果配置正确，Agent 会调用 PuppyOne 获取数据。

下一步

介绍自托管