项目¶

让每一项工作各归其位。项目是你智能体服务器上一个独立的文件夹，有自己的文件、自己的说明和自己的对话。装修的事归装修，论文的事归论文，全都在同一个智能体上。

🏠 通用你的主文件夹

💬每周计划
💬报税问题

📁 装修新聊天从这里开始

📝“预算 1.5 万欧元，每次都比较三家报价”
📄报价单.pdf · 平面图.png
💬厨房瓷砖
💬电工排期

📁 家庭旅行👥 共享

📄机票.pdf
💬每日行程

项目能给你什么¶

独立的文件夹

智能体在项目的文件夹里工作：你在项目对话中发送的文件会存到这里，它生成的文件、运行的代码和安排的任务也都在这里。
自己的说明

一份智能体在项目里每次开始对话时都会先读的备注：这个项目是做什么的、该怎么做、需要记住什么。
自己的对话

对话列表显示的是你当前所在的项目，每个新聊天也都从这里开始。不用特意去记，也不用事后归类。
私有或共享

在你与他人共享的智能体上，项目可以只属于你，也可以连同文件和对话一起与所有人共享。

除此之外的一切在每个项目里都完全相同：智能体的记忆和人格、技能、模型和设置、密钥和登录信息，以及你的额度。面板里的文件管理器和终端始终显示整台服务器。切换项目改变的是智能体在哪里工作，而不是它是谁。

1 开启项目¶

在有人开启之前，项目功能一直是关闭的；关闭期间，界面上不会出现任何与项目有关的内容：所有对话都在你的主文件夹中工作。这是一项新功能，所以面板会把它标为测试版。

面板： 设置 → 项目 → 使用项目。
Telegram： 发送 /projects，然后点按 ▶️ 开启项目。

这个开关作用于整个智能体：任何使用它的人，无论是所有者还是受邀用户，都可以开启或关闭。关闭不会动任何文件夹。在某个项目中开始的对话仍然在那里继续工作；只有新对话会回到你的主文件夹。

2 创建项目¶

面板： 打开侧边栏顶部的项目切换器，选择新建项目。输入名称，按添加项目，你就进入了这个项目，一个新聊天已经在等着你。
Telegram： /projects → ➕ 新建项目，然后发送名称。bot 会创建项目并把你切换进去。
设置 → 项目 → + 新建项目 可以在不离开当前项目的情况下新建一个。

每个项目都会在智能体的服务器上拥有自己的文件夹。

💡 如果你的智能体开启了允许其他用户，面板还会问谁可以看到：仅我自己或此智能体的所有用户。之后也可以更改，参见共享智能体上的项目。在 Telegram 中创建的项目默认是私有的。

3 在项目之间切换¶

在面板中，对话列表上方的切换器会显示你当前所在的项目。选另一个项目，列表就会换成它的对话，新聊天也会从那里开始。同一菜单底部的管理项目会打开设置。

在 Telegram 中，/projects（或 /menu → 设置 → 📁 项目）会列出你的项目：🏠 是你的主文件夹，📁 是你自己的项目，👥 是共享项目，当前项目带有 ✅。点按另一个即可切换。如果你所在的聊天属于别的项目，会立刻在你选中的项目里开始一个新对话，它的置顶标题以项目名称开头。之后 /sessions 会列出该项目的对话，并在顶部标明项目名称。

重命名、共享、编写说明和移除都在面板中完成。

值得了解：

对话留在它开始的地方。 切换绝不会移动已经在进行的聊天。它会保留自己的项目、文件夹和说明；切换决定的是下一个对话从哪里开始。
面板和 Telegram 各选各的。 你可以在 Telegram 上处于装修，而面板显示的是论文。两边各自记住自己的选择。

4 为项目编写说明¶

设置 → 项目 → 项目旁边的 ⋯ → 说明…

在那里写下智能体应该知道的事：这个项目是做什么的、涉及哪些人、已经做出的决定、你喜欢怎样的做事方式。智能体会在这个项目的每一次对话开始时读取它，所以你不必每次都重新交代背景。

举个例子

“我们家的装修。预算 15,000 欧元，3 月前完工。每次都至少比较三家报价。建一张费用表（费用.xlsx）持续记录，每收到一份报价就更新。”

把要点放在最前面

已经在进行的对话会沿用它开始时的说明，所以修改从下一个聊天起生效。说明写长一点也没关系，但只有开头几千个字符会直接交给智能体，其余部分它会在需要时从文件中读取。

说明以普通文件（AGENTS.md）的形式保存在项目文件夹里，所以你也可以让智能体帮你撰写或更新。

你的主文件夹¶

每个使用这个智能体的人都有自己的主文件夹，在切换器中显示为通用。项目关闭时，对话就在这里工作；启用项目之前的所有内容也都在这里。

通用是你的“家”，而不是一个项目：它不能被重命名、共享或移除。它也是处理跨多个项目工作的地方。在某个项目中，智能体只在该项目的文件夹内工作；而在通用中，它可以访问所有项目。

共享智能体上的项目¶

当你把智能体共享给其他人时，每个人都有自己的主文件夹和自己的项目。每个项目属于以下两种之一：

私有（默认）

只出现在你的列表中，也只有你的对话会进入其中。
共享

出现在智能体每位用户的列表中，并标有共享。所有人使用相同的文件和说明，其中的对话也是共享的。

在共享项目里，对话是大家的公共空间。 每个人都能在项目的列表中看到这些对话，可以阅读、继续、重命名或删除它们，所以几个人可以在同一个聊天里协作：在面板中，或在 Telegram 上——/sessions 会用 👥 标出这些对话，点按一下即可加入。每条消息都会显示是谁写的，智能体也知道自己在回答谁。它一次只回答一条消息：如果正在回答别人的消息，面板或 bot 会告诉你，等回复出来后再发送你的消息。

共享或设为私有：在项目的 ⋯ 菜单中选择与所有用户共享或设为私有。设为私有的项目会从其他人的列表中消失，他们在其中的对话会转到各自的主文件夹中继续。
谁管理共享项目： 创建它的人，以及智能体的所有者。重命名和移除由他们负责。只有创建者可以把它重新设为私有。
共享项目里的后台工作属于所有人。 每位用户都能在设置 → 后台工作中看到并修改它们，并在面板和 Telegram 上收到它们的通知。
当某位用户被移除时，他们共享的项目仍保持共享，并转交给所有者。他们的私有项目会从列表中消失，文件仍留在服务器上。

私有只是不显示，并不是上了锁

受邀用户是受信任的用户。所有人的工作都在智能体服务器上的同一个账户下运行，所以私有项目只是不出现在别人的列表里，并不是保险箱。真正需要保密的东西，不要放在共享的智能体上。

移除项目，或永久删除¶

删除分两步进行，避免误删：

⋯ → 从列表中移除。 项目会从列表中消失，但它的文件和对话仍留在服务器上，你在其中的对话会显示在通用下。你可以在设置 → 项目底部的已移除的项目中找到它，用放回列表把它恢复。
已移除的项目 → ⋯ → 永久删除… 这会删除该文件夹及其中的所有文件，以及在其中工作过的所有对话，并且无法撤销。确认时需要输入文件夹名称。如果是共享项目，面板还会告诉你有多少其他用户在其中有对话。

值得了解¶

重命名只改变名称。 文件夹保留创建时的名字，所以使用它的链接、脚本和工具都能继续正常工作。说明窗口会显示文件夹的真实名称。
你发送的文件留在项目里。 在项目对话中发送的文件会被复制到项目文件夹的 uploads 中，智能体直接在那里处理它。项目关闭时，文件照旧保存。
后台工作在项目中运行。 在设置 → 后台工作中，任务的第一个字段就是它所属的项目，新任务默认放在你当前打开的项目里。你在项目对话中让智能体创建的任务，也在该项目中运行。共享项目的任务会通知所有使用该智能体的人，其他任务只通知你。项目关闭时，每个任务只通知它的所属者。
搜索覆盖一切。 智能体会搜索你所有对话的历史记录，不论它们属于哪个项目，并能告诉你某条结果来自哪个项目。
API 在通用中工作。 通过智能体的 OpenAI 兼容 API 发出的调用，总是在调用者的主文件夹中工作。
最多 50 个项目。 一个智能体上所有人的项目合计最多 50 个。名称最长 60 个字符。