---
title: Gem:安装与使用
description: 从商店安装 Gem、在它的页面上设置、查看它做了什么、卸载。
section: guide
order: 50
updated: 2026-11-09
---
# Gem:安装与使用
Gem 是一个装进 Notochord 的小应用:它带着自己的工具、自动化流程(SOP),有的还带一个 AI 助手。装好以后,你可以在聊天里让 AI 用它,它的流程也会按自己的规则自动运行(比如每来一封新邮件运行一次)。
## 已装的 gem 在哪
打开「首页」,上方是你的项目,下方「Gem」一栏是你装的所有 gem,第一个图标是「商店」。点一个 gem,打开它的页面。
## 安装
在首页点「商店」,找到想要的 gem,点 **安装** 就装好了,不再弹确认——它是谁做的、能做什么,在商店的介绍里已经写明。装好以后直接打开这个 gem 的页面,在那里做设置(见下一节)。
Notochord 安装前会检查这个包:商店里的包必须有官方签名,内容没有被改动过,声明的权限写法合法。检查不通过就装不上。
**刚装好的 gem 什么都还碰不到。** 它要读的邮箱、要用的知识库内容、要用的外部账号,都要你在它的页面上打开以后才能用;在那之前它的请求会被拒绝。
## Gem 的页面
点开一个 gem 看到的页面,从上到下:
- **还需要完成设置**:还有需要你处理的事时才出现,比如它需要的账号还没连上、还没选它能读的邮箱或能用的知识库,或者给它选的模型可能做不了它要做的事。
- **设置**:装完以后的设置都在这里,随时可以回来改,改了马上生效。
- **AI 模型**:它的 AI 助手用哪个模型。下拉框里先是你的角色(选角色,就跟着你在「设置 › AI 设置 › 角色」里给这个角色配的模型走),再是你加过的所有模型。没选时用 `chat` 角色。还没加任何模型时不显示这一项。
- **账号**:它要用的外部账号(比如某个服务的 API key)。选一个已有的账号,或者新建一个,点 **保存**。没连上之前,它用到这个账号的功能会失败。
- **它能读的邮箱**:它能读哪些邮箱。装好时一个都没有,勾选的才能读;也可以勾「所有账号,包括以后添加的」。它的邮件触发只对你允许的邮箱生效。
- **知识库**:它能用知识库里的哪些内容。每一条都默认关闭,打开的才能用;需要你挑文件夹的,在这里勾选,勾选一个文件夹包括它里面的所有子文件夹。以后你把别的文件夹或文档移进这个文件夹,它也能读到;移出去就读不到了。下面还列出它用到的、关于你的事实和你现在的值(比如居住城市、喜欢的菜),可以直接修改或补填;gem 自己新加的那几项带着作者写的说明。你在这里写的,gem 不能改掉。
- **运行记录**:它的自动化流程每次运行的记录,最新的在最上面。点一条可以看这次运行的每一步做了什么、结果是什么。只有带自动化流程的 gem 有这一节。所有 gem 的运行也可以在首页的「运行记录」里一起看,在那里还能重试失败的运行、取消正在运行的。
- **它能做什么**:它能做什么——会访问哪些网站、会不会读邮件和知识库、包含哪些自动化流程、什么时候运行。下面的 **包含的内容** 列出它包含的工具、AI 助手和技能。
- **问题**:这个 gem 自己的代码出错的次数(只记哪里出错、出了几次,不记内容)。可以复制下来发给它的开发者。
## 卸载
在 gem 的页面右上角点 **删除**。它的工具、流程、定时任务和它自己存的数据都会删掉,不能恢复。它写进你知识库的内容默认保留,也可以选择一起删掉。
## 让模型能做 gem 要做的事
有的 gem 要求模型能看图片、听音频等等。给它选模型时,如果这个模型可能做不到,下拉框下面会有一行提示。详见[配置模型](/zh/guide/models.md#给-gem-选模型)。