Contentful Agent Template：基于 Slack 的 Contentful 内容助手模板

基于 eve 构建的 Slack 版 Contentful 助手，由 Vercel Drives 提供内容的可搜索副本。直接在 Slack 中起草和编辑条目，然后在内容上线前审核发布请求。该智能体还处理资源上传，并可将结果以表格或图表形式呈现。

快速开始

Vercel 的项目设置流程会在你的 Git 账户中创建一个仓库，并创建一个 Vercel 项目。你将通过 Vercel Connect 创建并安装一个 Slack 应用，配置一个私有的 Vercel Blob 存储来保存用户的写作偏好，并会被提示添加以下环境变量：

变量	值
`CONTENTFUL_MANAGEMENT_TOKEN`	你的 Contentful Management API 令牌，需具备对你所配置空间的访问权限
`CONTENTFUL_SPACE_IDS`	你的 Contentful 空间 ID，或多个 ID 以逗号分隔

部署智能体后，将其添加到 Slack 频道并 @提及它，即可开始你的第一次对话。

智能体保存编辑内容但不会发布条目。默认情况下，发布需要在 Slack 中获得批准，届时会有一张卡片列出将要上线的条目和资源。任何已认证用户都可以批准或取消发布请求。

你可以将辅助内容类型（如作者或标注）豁免于审批。新上传的资源在添加到内容时会被处理并发布。有关这些选项及其对关联内容的影响，请参阅发布设置。

智能体会记住每个用户的写作偏好，例如语气或语言，并将其单独存储在私有的 Vercel Blob 存储中。在本地开发期间保存的偏好是临时的。

使用 Node.js 24 和 pnpm 进行本地开发。安装 Vercel CLI，然后克隆你的仓库并运行：

pnpm install
vercel link
vercel env pull .env.local
pnpm dev

当 vercel link 提示时，选择你已部署的项目。vercel env pull .env.local 会将你项目的开发环境变量保存到 .env.local。

pnpm dev 会在你的终端中打开 eve 的交互式聊天。输入诸如“列出我空间中的内容类型”之类的消息即可与智能体对话，它会读取并编辑你所配置的 Contentful 空间中的内容。

本地会话使用 just-bash，无法访问存储在 Vercel Drives 上的内容，因此搜索会直接查询 Contentful。请通过 Slack 中的智能体测试使用 Drives 的搜索和发布审批卡片。

部署前，请检查你的更改并确认智能体可以构建：

pnpm validate
pnpm exec eve info
pnpm build

使用 pnpm fix 应用自动格式化和 lint 修复。检查通过后，使用以下命令部署：

vercel deploy --prod

自定义项	位置
你团队的写作指南	agent/instructions.md
哪些内容类型需要审批	`CONTENTFUL_COMPONENT_TYPES`
网站 URL 查询	`CONTENTFUL_PUBLIC_ORIGIN` 和 `CONTENTFUL_PAGE_ROUTES`
无需提及即可接收回复的 Slack 频道	`SLACK_AUTO_REPLY_CHANNEL_IDS`
模型和会话限制	agent/agent.ts

有关自定义智能体的更多信息，请参阅 CUSTOMIZATION.md。