說明文件

實際上要怎麼用

新團隊第一天需要的三件事。這裡寫的都是產品今天出貨的樣子。

代理人是什麼，以及要怎麼要一個

代理人是一段針對單一物件寫成的 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 用戶端看得到的一切，都限定在它所用權杖對應的那個帳號：該帳號的代理人、執行紀錄與點數，別的都沒有。

免費方案包含一個啟用中的代理人與一次排程執行——足以在任何人簽下任何東西之前，看出這個形狀合不合用。