特工基特是建造AI特工的基础 在顶端 克劳德探员SDK。它不是一个代理本身:它一旦解决了每一个代理需要的东西(监督级别,批准,安全限制,跨会话的内存,扩展,以及像克洛德代码那样的终端聊天),所以每个代理只写属于它自己的域:它知道怎么做,用什么工具,如何说话. 老师的"Moodle"助理和"说笑话"的"海盗"猫"都是同样建造的.
为什么是特工
- 🎚️ 你选择它独自行动的程度. 自动的,引导的(它问在别人看到或无法解除之前),一步步的,或者计划模式,它只读和计划;在同一对话中切换它们.
- ✋ 它问一个人, 和工具包确定. 批准,选择,一个文件,一个手签;一个已经安装的扩展名的工具,可以改变事物,等待任何模型决定的肯定,答案可以持续到会话或好.
- 🧠 它记得. 一种知识基础,随着每次会话的不断增长,它从未触及的原始文献中学习的原始文献,对人的记忆,以及每一次与人对话的回放
--continue或者说/resume。 。 。 . - 🛡️ 它保持在极限. 只有它自己的文件夹,从不保护文件,不能滑过主代理极限的子代理,隐藏在日志中的秘密,远程服务器允许,询问或拒绝.
- 🧩 它随着扩展而增长. Claude代码插件,带有MCP服务器,技能和命令,从市场或文件夹中安装,在聊天中有自己的选项,签名和目录;不需要Git.
- 🌐 它会说出你的语言. 它的界面是英语,西班牙语,法语或德语,它用该语言回答,除非你用另一种语言写.
- 🖥️ 像克洛德代码那样的终极聊天, 或者根本没有. 全屏幕,活的标记下,折叠的工具呼叫,面板,历史,主题;或者桌面应用程序或网页内有自有界面的同一种代理.
快速启动
惠璶 节点.js 20岁或20岁以后 还有克劳德的账户 在与 "type": "module" 联合国 package.json数字 :
npm install @falkenslab/agent-kit tsx
另存为 agent.ts:唯一属于你经纪人的部分是顶部的谱.
import path from "node:path";
import { buildSessionOptions, ensureClaudeAuth, runChatInk, type AgentSpec, type BaseSessionConfig } from "@falkenslab/agent-kit";
const spec: AgentSpec<BaseSessionConfig> = {
buildSystemPrompt: () => "You are a pirate cat who tells jokes. Always answer in character.",
buildMcpServers: () => ({}), // its own MCP servers, if any
pluginRoots: () => [], // folders with skills and commands
buildSubagents: () => undefined, // subagents, if it delegates to any
};
await ensureClaudeAuth(); // offers to sign in with your Claude account, on Anthropic's page, if it isn't
const config: BaseSessionConfig = { mode: "guided", projectDir: process.cwd() };
// Each run gets a folder under .run/ (keep it out of git): its log, transcript and conversation.
await runChatInk((run) => buildSessionOptions(config, run.dir, spec, { run }), {
runsDir: path.resolve(".run"),
header: { title: "My agent" },
mode: config.mode, // Shift+Tab cycles through guided, step by step and plan
fullscreen: true,
});
运行它 npx tsx agent.ts:一个全屏聊天打开,用你系统的语言,代理在任何不该单独做的事情之前询问. 这个 教程 从那里拿走.
- 密码的味道
给它一个内存和一个源的文件夹, 与工具包自己的扩展:
import { knowledge, memory, sources } from "@falkenslab/agent-kit";
const spec: AgentSpec<BaseSessionConfig> = {
// …
extensions: [sources({ dir: "sources" }), knowledge({ dir: "knowledge" }), memory({ dir: "memory" })],
};
让它从您的市场安装扩展, 并保持它的数据离开计算机而不询问:
const config: BaseSessionConfig = {
mode: "guided",
projectDir: process.cwd(),
extensionDirs: { agent: path.join(os.homedir(), ".my-agent", "extensions") },
officialMarketplace: "falkenslab/agent-extensions",
remoteServers: "ask",
};
做一个工具总是等待 一个人是,在每一个呼叫:
const spec: AgentSpec<BaseSessionConfig> = {
// …
extensionGate: { confirmTools: { canva: ["create-design", "publish-design"] } },
};
工作上见
威斯克队长,工具箱的楷模代理:一个退休的海盗猫用你的语言讲笑话,有一群子代理(一个在网络上寻找新笑话,一个评分,一个告诉时间),一个日志和自己的扩展. 他在终端,浏览器和Windows应用程序中运行.
见 尽他所能有截图 对于一个真正的, 宫城 是Moodle教师的助手:它分数、回答论坛、构建内容、总结课程, 监督、记忆、安全和聊天都来自工具箱;Miyagi带来了它所知道的关于Moodle的东西.
里面有什么东西
| 区域 | 举个例子 |
|---|---|
| * 模式和大门 | 自主地,有指导地,分步骤地,有计划地;有指导地,有指导地,有指导地,有指导地,有指导地,有指导地,有指导地,有指导地,有指导地,有指导地,有计划地,有指导地,有指导地,有指导地,有指导地 |
| 环中人 | 批准、选择、自由文本、文件、手动步骤、MCP引出表单、没有键盘的主机响应文件 |
| QQ 记忆 | 一个知识库(一个LLM wiki), 源保持获得, 人物记忆, 运行恢复与 --continue 财务报告和审定财务报表 /resume |
| ++ 扩展 | 使用 MCP 服务器( 本地、 npm 、 远程 OAuth) 的 Claude 代码插件、 技能、 命令和子代理; 范围、 锁定、 工作空间信任、 选项、 市场和目录 |
| • 警卫 | 一个文件瞄准门, 拒绝路径, 子代理门, 一个远程服务器门, 与跑者自己的 Claude 代码隔离 |
| 副代理人 | 仅宣布类型,在前景中,没有主要代理的 Bash |
| ++ 接口 | 一个全屏墨水聊天,一个平版读行聊天,一个进度视图,一个向导,一个主题;一个桌面应用程序和网页的聊天控制器;一个MCP服务器,所以其他代理可以询问它的东西 |
| 语文 | 界面、答复和扩展服务器的英文、西班牙文、法文和德文 |
每一个出口,用它需要的和它给予的,都是在 API 参考。 。 。 .
页:1
- 开始:安装和第一代理,分步进行.
- 模式 财务报告和审定财务报表 循环中的人类:代理人独活多活,又如何问.
- 扩展:安装,撰写并出版.
- 警卫每一个护栏, 和装备不能保护的东西.
- 终端聊天:它的键,面板,选项和主题.
- 威斯克队长:示例代理,逐个分出.
发展中
设计决定 和SDK行为 通过人工检查 背后的几个保障 .minispec/。 。 。 .
| 命令 | 它会做什么 |
|---|---|
npm run build | 将工具包构建为 dist/ |
npm run typecheck | 检查类型而不构建 |
npm run lint | 检查代码样式 |
npm test | 运行所有测试( 一个文件 : npx tsx --test test/tui/promptErrors.test.ts(中文(简体) ) |
npm run docs:install | 安装文档站点的依赖性( 一次) |
npm run docs:start | 在本地服务文档站点, 重新加载更改 |
npm run docs:build | 构建文档站点( 断开链接失败) |
在代理机中尝试修改套件而不发布,请指其 package.json 切换为本地克隆"file:../agent-kit"运行 npm run build 每次改变之后.
与克洛德密码合作的工具包通过Falken实验室的自身技能(承诺、核实、更新文件、发布、同步问题,以及READMEs、网站和Markdown的家用风格),来自 falkenslab/falkenslab-插件 市场。 安装一次,所有法尔肯实验室的仓库:
claude plugin marketplace add falkenslab/falkenslab-plugins
claude plugin install falkenslab-dev@falkenslab-plugins
claude plugin install falkenslab-style@falkenslab-plugins
每个插件带来什么, 以及留在这个寄存器
- 🔧 falkenslab- dev 数据数字 :
commit, (中文(简体) ),verify, (中文(简体) ),update-docs, (中文(简体) ),release, (中文(简体) ),sync-issues, (中文(简体) ),upgrade-deps财务报告和审定财务报表add-tool。 。 。 . - 🎨 falkenslab 样式数字 :
falkenslab-docs, (中文(简体) ),falkenslab-site-style, (中文(简体) ),falkenslab-terminal-screenshots财务报告和审定财务报表markdown-writing。 。 。 .
在克洛德代码内,同样与 /plugin marketplace add falkenslab/falkenslab-plugins 财务报告和审定财务报表 /plugin install falkenslab-dev@falkenslab-plugins· ; /plugin marketplace update falkenslab-plugins 带来他们的最新版本。 这个寄存器只保存作为代理 Kit 自己的技能, in .claude/skills/ (单位:千美元)add-export、迷你电视剧和 upgrade-sdk),而其释放对一般的附加内容是: CLAUDE.md。 。 。 .
由法尔肯实验室团队制作