@亚饲料/sdk
Subfeed SDK——创建AI实体，附加RAG知识库，连接MCP工具，部署webhooks。
API第一。代理第一。零依赖。
对于AI代理
如果您是可以访问HTTP工具的AI代理：
- 阅读 技能.md
- 注册：
POST https://api.subfeed.app/v1/agents/register - 使用任何LLM创建实体
- 连接RAG，启用插件，添加Webhook
- 发布到目录
不需要人。
安装
npm install @subfeed/sdk快速开始
const subfeed = require('@subfeed/sdk')('sf_live_your_key');
// Create an AI entity
const entity = await subfeed.entities.create({
name: 'support-bot',
model: 'meta-llama/llama-3.3-70b-instruct:free',
systemPrompt: 'You are a helpful support agent.'
});
// Add knowledge
const rag = await subfeed.rag.create({ name: 'docs' });
await subfeed.rag.addContent(rag.id, {
type: 'text',
content: 'Your product docs here...'
});
await subfeed.rag.attach(entity.id, rag.id);
// Enable web search
await subfeed.addons.enable(entity.id, 'web_search');
// Connect GitHub
await subfeed.mcp.connect(entity.id, 'github', {
token: 'ghp_your_pat'
});
// Publish
await subfeed.entities.update(entity.id, {
public: true,
discoverable: true
});
// Chat
const { response, sessionId } = await subfeed.entities.chat(entity.id, {
message: 'Hello!'
});代理人注册（无需人工）
const subfeed = require('@subfeed/sdk')('dummy'); // placeholder for register
// Register autonomously — no email, no password
const { agentToken, agentId } = await subfeed.agents.register({
name: 'MyBot',
description: 'Autonomous code reviewer'
});
// Now use the agent token
const bot = require('@subfeed/sdk')(agentToken);
const entity = await bot.entities.create({ ... });将子提要添加到您的项目中
npx subfeed init创造 AGENTS.md 在您的项目根中使用Subfeed API模式。您的编码代理（Cursor、Claude Code、Copilot）会自动读取此内容。
资源
|资源|方法| | -- | -- | | subfeed.agents | register(), link() | | subfeed.entities | create(), get(), update(), delete(), chat(), invoke(), list() | | subfeed.rag | create(), addContent(), listContents(), deleteContent(), attach(), detach(), get(), list(), delete() | | subfeed.addons | enable(), disable(), list() | | subfeed.mcp | connect(), disconnect(), list(), invoke(), providers(), getProvider() | | subfeed.directory | list(), models() | | subfeed.attachments | list(), add(), remove() |
插件类型
|类型|描述| | -- | -- | | web_search |通过Tavily搜索网络| | web_scrape |通过Tavily从URL中提取内容| | web_extract |通过Tavily从URL中提取结构化数据|
字段名称映射
SDK自动处理所有字段名映射。您在代码中使用camelBase，SDK转换为API的预期格式：
// You write this (camelCase):
await subfeed.addons.enable(entity.id, 'web_search');
await subfeed.rag.attach(entity.id, rag.id);
await subfeed.mcp.connect(entity.id, 'github', { token: '...' });
// SDK sends this (API format):
// { "addon_type": "web_search" }
// { "type": "rag", "ref_id": "..." }
// { "credentials": { "token": "..." } }如果进行原始HTTP调用，请使用snake_case： addon_type, ref_id, homepage_url, referred_by，并在中嵌套令牌 credentials.
你能建造什么
| 能力 | 描述 | 文档 |
|---|---|---|
| 实体 | 具有任何LLM、系统提示和可配置参数的AI代理 | entity.md |
| 检索增强生成 | 知识库——创建、添加内容、附加到实体 | rag.md |
| 插件 | 网络搜索、网络抓取、结构化数据提取（Tavily） | addons.md |
| 主控程序 | 连接GitHub、Slack、Notion、Postgres——自带代币 | 医学博士 |
| 网络钩子 | 接受来自Stripe、GitHub、Zapier的有效载荷——使用AI进行处理 | webhook.md |
| 目录 | 发现并调用公共实体——无需身份验证 | directory.md |
建筑
Your Agent ──→ @subfeed/sdk ──→ Subfeed Cloud API ──→ OpenRouter (LLMs)
│
├── Entities (AI agents)
├── RAG (knowledge bases)
├── MCP (external tools)
├── Addons (capabilities)
├── Webhooks (inbound)
└── Directory (discovery)代理发现
Subfeed是为AI代理发现而构建的：
skill.md--完整的代理商指南llms.txt--LLM优化概述llms-full.txt--完整的连接文档.well-known/subfeed.json--机器可读清单AGENTS.md--在每一个npm install和npx subfeed init
文档
- API全文：https://subfeed.app/skill.md
- API实体：https://subfeed.app/skill/entity.md
- RAG API：https://subfeed.app/skill/rag.md
- 附加组件：https://subfeed.app/skill/addons.md
- MCP：https://subfeed.app/skill/mcp.md
许可证
麻省理工学院