Dokki Docs logo

安装和自定义

On this page

从蓝图安装代理,然后调整其指令和访问权限,再用于重复性工作。

安装代理

  • 转到 工作区 → 代理 → 蓝图。

  • 打开蓝图,查看角色、指令、技能和建议的连接。

  • 选择个人或组织使用,为代理命名,并在需要时选择主工作区。

  • 完成安装并打开代理的控制面板。

编写有用的常设指令

描述代理的用途、预期输出、约束条件以及何时应请求批准。请勿在指令和记忆中保存凭据和私钥。

限制工作区访问

打开 工作区,仅允许代理所需的工作区。主工作区存储设置材料;它不会自动授予对所有资源的访问权限。

选择谁可以使用组织代理

组织代理具有可见性设置:

  • 共享 允许组织中的每个成员使用该代理。组织所有者和管理员可以在其许可证允许的情况下管理其配置。

  • 仅限我 使代理在组织内仅对其创建者可见。

只有代理的创建者才能更改此设置。在将共享代理更改为 仅限我 之前,请查看其计划:Dokki 会立即移除其他成员的访问权限,并暂停他们创建的计划。

添加技能和固定上下文

对于可重复的程序,使用 技能。对于代理应经常考虑的一小组资源,使用 固定。当流程发生变化时,更新或删除它们。

连接外部工具

当此代理需要专用的外部 MCP 服务器时,请使用代理的 MCP 选项卡。通过其支持的登录流程添加服务器,或者当服务器应锁定到单个 Dokki 工作区时,粘贴完整的 Workspace Connector URL。

在启用之前:

  1. 确认谁拥有外部服务或连接器。

  2. 授予所需的最小外部范围。

  3. 请勿将令牌和连接器 URL 放入代理指令、记忆和固定文档中。

  4. 单独查看代理的 工作区 列表;MCP 连接不会扩展 Dokki 的访问权限。

  5. 运行一次手动只读测试并检查结果。

  6. 在允许无人值守的变更之前,请查看计划。

  7. 当代理、所有者或工作流发生变化时,撤销或移除连接。

对于用户的 SaaS 账户(如 GitHub、Gmail 或 Slack),请优先使用 连接 → MCP 应用。对于需要访问 Dokki 的外部 AI 客户端,请使用 连接 → AI 客户端。有关总体方向和授权模型,请参阅 连接;有关外部账户详细信息,请参阅 MCP 应用。

暂停或卸载

当代理应停止接受新工作时,请暂停它。请单独查看计划。在卸载之前,请保存需要保留的任何输出或指令,因为卸载会移除已安装的代理。