TUNC.AI / Tunc Orb 示例

Tunc Orb 示例与智能体搭法提示词

Tunc Orb 的三种可用搭法,每种都配一段智能体照着做的提示词:共享的项目记忆、把结果写进日志的定时任务,以及已处理条目的状态。

更新于

下面每种搭法都从一段提示词开始:把它贴给智能体,剩下的由智能体做。不要把 API 密钥放进提示词:用环境变量或密钥管理交给你的工具。Tunc Orb 文档里有每个调用;这一页有的是能用的搭法。

让你的智能体连接到 Tunc Orb

在 Claude 里最快的方式是一个填好内容的链接。它会打开“Add custom connector”,名称和地址已经填好;核对一下再确认。

把 Tunc Orb 加到 ClaudeClaude 免费版只允许一个自定义连接器。Team 和 Enterprise 由 Owner 添加。

在 Claude Code、Cursor,或任何能运行命令、能改自己设置的智能体里,把下面这段贴进去。它会添加连接、等你登录,然后测试一次:

把这段贴给你的智能体
把 Tunc Orb 连接到这个会话。它的 MCP 服务器是 https://mcp.tuncorb.com/mcp。如果你能运行命令,就运行:claude mcp add --transport http tunc-orb https://mcp.tuncorb.com/mcp。否则把它加到我的 MCP 设置里。然后让我登录(在 Claude Code 里:运行 /mcp,选择 tunc-orb,再 Authenticate),等我确认。之后测试一次:保存一条名为 test/hello 的记录,说明是“连接测试”,文本是“能用了”,再把它读回来,然后删除。告诉我你做了什么,以及返回了什么。

在 ChatGPT,或者任何通过菜单添加连接器的应用里,让智能体读说明并一步步带你做:

把这段贴给你的智能体
读 https://tuncorb.com/llms.txt,按菜单一步一步告诉我怎么把 Tunc Orb 接到这个应用里。用登录的方式,不要用 API 密钥。如果这个应用需要特殊模式才能添加连接器,告诉我是哪一个。

智能体可以添加连接,但不能替你登录:你在浏览器里授权一次,并选择它可以做什么。想手动做的话,每个客户端的步骤都在下面:

客户端步骤
claude.ai, Claude Desktop and Claude mobileCustomize → Connectors → Add custom connector → 名称填 Tunc Orb,URL 填 https://mcp.tuncorb.com/mcp → Add → Connect。免费版只允许一个自定义连接器;Team 和 Enterprise 由 Owner 在 Organization settings → Connectors 里添加。这个链接会打开对话框,名称和 URL 已经填好:
https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Tunc%20Orb&connectorUrl=https%3A%2F%2Fmcp.tuncorb.com%2Fmcp
Claude Code先添加服务器,然后运行 /mcp,选择 tunc-orb,再 Authenticate。
claude mcp add --transport http tunc-orb https://mcp.tuncorb.com/mcp
ChatGPTSettings → Apps & Connectors → Advanced → 打开 Developer mode → Create → 名称填 Tunc Orb,URL 填 https://mcp.tuncorb.com/mcp,Authentication 选 OAuth → Create → Connect。
Cursor加到 ~/.cursor/mcp.json,然后 Settings → MCP:会显示“Needs login” → Login。
{
  "mcpServers": {
    "tunc-orb": {
      "url": "https://mcp.tuncorb.com/mcp"
    }
  }
}
VS Code (Copilot)命令面板 → MCP: Add Server → HTTP → https://mcp.tuncorb.com/mcp → 名称 tunc-orb → 允许登录提示。
Gemini CLI加到 settings.json,然后运行 /mcp auth tunc-orb。
{
  "mcpServers": {
    "tunc-orb": {
      "httpUrl": "https://mcp.tuncorb.com/mcp"
    }
  }
}
Copilot StudioTools → Add a tool → New tool → Model Context Protocol → URL 填 https://mcp.tuncorb.com/mcp → Authentication 选 OAuth 2.0,Dynamic discovery。

在 Claude、Cursor 和 ChatGPT 之间共享一份项目简报

要做的事:你在几个助手里推进同一个项目,每次都要把同样的背景重贴一遍。搭法:一条记录放简报,一个日志放决策。连到你的 Tunc Orb 的每个助手都能读到这两样。

先设置一次。把下面这段贴给最了解这个项目的助手,换成你自己的项目名:

把这段贴给你的智能体
在 Tunc Orb 里为“Acme 网站改版”建立项目记忆。不知道的事情问我。存一条记录 projects/acme-redesign/brief,写清目标、给谁用、当前状态、未解的问题,以及文件放在哪里,并给它一行说明“Acme 改版:简报与状态”。控制在 300 字以内,不要写入决策历史。然后新建一个日志 projects/acme-redesign/decisions,说明是“Acme 改版:决策与原因”,把到目前为止的每个决策作为一条条目加进去,带上日期和原因。做完把两个名字都给我看。

换一个助手,或者开一个新对话,接着做:

把这段贴给你的智能体
看看 Tunc Orb 里的 projects/acme-redesign/brief,以及 projects/acme-redesign/decisions 最新的五条条目,然后在我们开始之前告诉我上次停在哪里。

一次工作结束的时候:

把这段贴给你的智能体
用新的状态和未解的问题更新 projects/acme-redesign/brief,并把今天做的每个选择各加一条到 projects/acme-redesign/decisions,带上原因。简报保持在 300 字以内。

Tunc Orb 在改记录之前会校验版本,所以两个助手不会悄悄互相覆盖:后一个会重新读一次再试。想让助手不用你开口就去看,就给它常驻指令里加一行(Claude 项目说明、CLAUDE.md 或 Cursor 规则):“在这个 Acme 改版项目开始时,先读 Tunc Orb 的 projects/acme-redesign/brief。”

让定时任务把结果写进智能体能读的日志

要做的事:每周的检查、夜间的导入或者一个 n8n 流程会产生一个结果,出事之前没人去看。搭法:任务往一个日志里追加一条条目,你问任何助手最近几次跑得怎么样。Tunc Orb 只负责存条目;它不会唤醒智能体,也不会发消息。

在 https://tunchub.com/account/keys/new?product=orb 创建一个只带这个任务需要的权限(在 Tunc Orb 里读和保存)的 API 密钥,用环境变量或密钥交给任务。然后把下面这段贴给你的编码智能体:

把这段贴给你的智能体
写一个脚本 report.py,运行我的每周流量检查,然后通过 https://api.tuncorb.com/v1/write(append 操作)往 Tunc Orb 日志 runs/weekly-traffic 追加一条条目。每条条目写:日期、ok 或 failed、关键数字,有链接就带上链接。第一条条目会创建这个日志,说明写“每周流量检查结果”。从环境变量 TUNC_API_KEY 读 API 密钥,永远不要打印出来。每条条目生成一个新的 mutation_id,重试时复用同一个。请求的具体形状看 https://tuncorb.com/docs。

之后,在任何一个已连接的助手里:

把这段贴给你的智能体
读 Tunc Orb 日志 runs/weekly-traffic 最新的五条条目(每次运行一条:日期、ok 或 failed、关键数字)。有哪次失败了吗?数字和上一次比变动超过 10% 吗?

让每一条都只处理一次,即使有多个智能体

要做的事:一个智能体分派工单、邮件或线索,你既不能重复处理,也不能在对话结束后丢掉进度。搭法:一条记录放已经处理过的 id。每个智能体先读它,跳过已列出的,再用一个写明所读版本的补丁加 id。如果期间别的智能体改过这条记录,改动会以 revision_conflict 被拒绝,智能体就重新读一次。

把这段贴给你的智能体
你负责分派服务台工具里的新工单。先读 Tunc Orb 记录 triage/support/processed;如果它不存在,就用一行说明“已处理的工单 id”和值 {"ids": []} 创建它。跳过 id 在列表里的每个工单。回复或关闭一个工单之后,用你在读取时拿到的版本,通过补丁(add /ids/-)把它的 id 加进去。如果 Tunc Orb 返回 revision_conflict,就重新读这条记录,看看 id 是不是已经在了,不在才加。永远不要删除这条记录。最后告诉我你处理了多少个工单,跳过了多少个。

同样的模式适用于收件箱、线索列表、待转换的文件夹,或者待检查的页面队列。因为状态在 Tunc Orb 里而不是在对话里,新开的会话或者换一个助手都从同一份清单接着做。每次都会整条读取,所以队列很忙时每月换一条新的,例如 triage/support/processed-2026-10。

把文件的 id 和你的笔记放在一起

Tunc Art 保存助手做出来的文件。把文件的 artifact_id 记进一条 Tunc Orb 记录,之后任何助手都能打开那个文件:id 能打开它,链接只给人用。这需要两个产品都连上。

把这段贴给你的智能体
把这份报告以 2026-10-weekly-report.pdf 存到 Tunc Art。然后把 Tunc Orb 记录 reports/latest 更新成这个文件的 artifact_id、文件名、到期时间和今天的日期,并把链接给我。

值得知道的

  • 记录和日志一直保留到你删除。一条记录最大 16 MiB,一次调用最多发送 64 KiB,所以长记录用补丁一段段长大。
  • 名称和一行说明是不加密存储的,这样智能体才能找到记录。不要把秘密放进去。
  • 免费账号有一个书架,所有已连接的智能体共用它,每个智能体都能读里面的每条记录。
  • 给多个客户做事?连到一个 Tunc 账号上的每个智能体都能读它的全部书架,而一个账号只有一个组织。那就一个客户一个 Tunc 账号,把每个客户的智能体接到各自的账号上。