SuperAPI AI 工具集

create-agent-with-sanity-context

智能体与模型

查看项目

更新于 10-16 08:45

技能介绍

用途:帮助用户构建能结构化访问 Sanity 内容的 AI 智能体,例如 Sanity 驱动的聊天机器人或接入 Sanity 内容的 AI 助手。

主要能力:Sanity Context 具备 schema 感知能力,智能体可理解内容结构、用真实字段值查询、跟踪引用,并把结构过滤与语义搜索结合。提供两种检索模式:GROQ 模式(数据集源,智能体按 schema 用 GROQ 查询实时数据集,适合目录、文章、FAQ 等结构化内容);知识库模式(beta,读取预先构建的索引,适合答案分散在多处散文内容中的场景)。一个端点只服务一种模式,若同时有数据集源和知识库源,数据集优先且知识库被忽略。

使用方式:需要 MCP 端点 URL(SANITY_CONTEXT_MCP_URL)、组织 API 令牌(SANITY_ORGANIZATION_TOKEN,需在组织权限中勾选 Context,只读选 Viewer,记录 Insights 选 Editor,项目令牌无效)以及 LLM API 密钥。组织管理员需先在 Labs 页面启用 Context。集成模式为:通过 /initial-context HTTP 端点获取初始上下文并注入系统提示;用 HTTP 传输连接 MCP 端点;用 Bearer 令牌认证;从 MCP 客户端获取工具列表传给 LLM;设置系统提示说明角色、语气与边界。初始上下文应始终提供给模型,可内联进系统提示或保留 initial_context 工具,二者不可都缺。长驻服务建议用短 TTL 缓存(参考实现为 5 分钟)。不要硬编码工具列表,应从 MCP 客户端获取。

限制:组织令牌是服务端密钥,绝不能进入浏览器。GROQ 模式需从 Studio v5.1.0+ 部署 schema,端点才能服务;知识库模式不需要部署 schema。创建端点需组织 Administrator 或 Developer 角色。资料未提供具体收费、价格与效果数据。