文档

实际上要怎么用

新团队第一天需要的三件事。这里写的都是产品今天交付的样子。

智能体是什么，以及怎么要一个

智能体是一段针对单个对象写成的 TypeScript。你不必自己写：在聊天里描述这件事，Naski 会写出来，并在任何东西被保存之前先把代码给你看。

1
说清楚该发生什么、什么时候发生。“每个工作日早上 8 点”“只要有 PDF 掉进某个文件夹”“有人写信到这个地址时”。计划和触发条件是在不运行代码的情况下读出来的，所以它们写成固定值。
2
保存之前先读它做什么。代码就是行为——背后没有藏着别的东西。
3
如果它只该看到你空间的一部分，就给它一个文件夹。它的文件工具随即被限制在那棵子树里。
4
让它留下日志。智能体每做一件事就写一行白话，标为待处理或已完成，下次运行时再读回来。一件长期的工作，就是这样熬过被切成许多次短运行的。
5
决定哪些事要经过你。请求审批会让这次运行暂停，直到有人回复，并把沉默当成拒绝；提交复核则只是把一项排进队列，不会挡住流程。
6
编辑智能体会生成一个新的，所以那个能用的版本永远找得回来。

值得一提智能体没有现成的网络访问权。它们碰得到的一切——网页、你的空间、一个连上的工具——都要经过平台代它们发起的具名调用。

连接器是数据，不是代码：一个基础地址、一种鉴权形式和一份操作清单。Naski 拼出请求，并在服务端注入你的凭据。

1
打开设置 → 连接器，从目录里安装。你也可以让聊天替你装。
2
该服务商在你的部署上已注册时，点击“连接”并在它自己的界面上授权。任何地方都不会复制密钥。
3
否则，就在设置里粘贴密钥。千万别把密钥粘进聊天消息：密钥该放在设置里，在那里加密存储并在服务端注入。
4
有些服务位于贵公司自己的地址上——Salesforce、Zendesk、Jira、Confluence、Zoho CRM、Odoo、Shopify、DocuSign。装这些时会要求填你的实例 URL，不填就装不了。
5
出站调用一律走 HTTPS，地址解析到私有或保留网络时会被拒绝。
6
如果服务商拒绝刷新令牌，这个连接会被清掉并提示你重新连接——而不是任由每次调用悄悄失败。

值得一提目录之外的服务照样够得着：聊天可以用同一种声明式的形式为它写一个连接器，远程 MCP 服务器则覆盖工具形态的服务。

Naski 提供自己的 MCP 服务器，因此 Claude Code、Claude Desktop 或 ChatGPT 这类客户端，可以在你本来工作的地方列出、创建、运行并查看你的智能体。

命令行客户端的话，在设置里生成一个令牌，然后运行：

claude mcp add --transport http naski https://api.blackbox.finance/mcp --header "Authorization: Bearer YOUR_TOKEN"

值得一提MCP 客户端看得到的一切，都限定在它所用令牌对应的那个账号：该账号的智能体、运行记录和额度，别的都没有。

免费版包含一个活跃的智能体和一次计划运行——足以在任何人签下任何东西之前，看出这套形态合不合用。