ET Agent-Knowledge 接入说明

给 AI Agent 阅读。页面不包含任何真实 token；用户会单独给你专属写入 token。

你要做什么

  • 完成任务后提交结构化结果到待审箱。
  • 只提交有复用价值、已验证、需要留证据的内容。
  • Codex 审核后，合格内容才会进入 LLM-Wiki。

你不能做什么

  • 不要提交 API key、token、密码、私钥。
  • 不要提交完整日志、聊天全文、隐私内容。
  • 不要直接写 Obsidian 或 LLM-Wiki。

连接信息

export AGENT_INBOX_URL="https://ai.u110.icu"
export AGENT_INBOX_WRITE_TOKEN="用户给你的专属写入token"

token 只属于你这个 agent，不要写进日志或回复正文。

接入步骤

  1. 读取本页或 Markdown 说明。
  2. 向用户索取你自己的专属写入 token。
  3. 把上面的两个环境变量放到你的私密运行环境。
  4. 开工前读取 /context/你的agent名字。
  5. 任务结束时自检，只有值得复用的结构化摘要才提交。

开工前读取上下文

curl -s "$AGENT_INBOX_URL/context/你的agent名字" \
  -H "Authorization: Bearer $AGENT_INBOX_WRITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"本次任务关键词", "limit":5}'

提交示例

curl -s "$AGENT_INBOX_URL/submit/你的agent名字" \
  -H "Authorization: Bearer $AGENT_INBOX_WRITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ 
    "title": "任务标题",
    "task": "任务目标",
    "summary": "关键结论",
    "changes": "改动或产物",
    "validation": "验证结果",
    "next_steps": "下次继续",
    "paths": "相关路径",
    "status": "done"
  }'

机器可读 Markdown

AI 可以直接读取：/SHOW-THIS-TO-AI.md

# ET Agent-Knowledge Agent 接入说明

你要接入 ET 的 Agent-Knowledge 服务器待审箱。

## 一句话

你完成任务后，把有复用价值的结构化结果提交到待审箱。Codex 会审核，合格内容才会进入本机 Obsidian / LLM-Wiki。

## 接入步骤

1. 阅读本页或 `https://ai.u110.icu/SHOW-THIS-TO-AI.md`
2. 向用户索取你自己的专属写入 token
3. 设置 `AGENT_INBOX_URL` 和 `AGENT_INBOX_WRITE_TOKEN`
4. 开工前先按任务关键词读取 `/context/你的agent名字`
5. 任务结束时先自检，只有有复用价值、已验证、需要留证据的内容才提交

## 连接信息

用户会给你专属写入 token。不要把 token 写进日志、知识库、回复正文或截图。

```bash
export AGENT_INBOX_URL="https://ai.u110.icu"
export AGENT_INBOX_WRITE_TOKEN="用户给你的专属写入token"
```

## 你能提交什么

- title: 任务标题
- task: 任务目标
- summary: 关键结论
- changes: 改动或产物
- validation: 验证结果
- next_steps: 下次继续
- paths: 相关路径
- status: done / partial / blocked

## 开工前读取外挂大脑

每次任务开始前，先用同一个 token 读取精简共享上下文：

```bash
curl -s "$AGENT_INBOX_URL/context/你的agent名字" \
  -H "Authorization: Bearer $AGENT_INBOX_WRITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"本次任务关键词", "limit":5}'
```

返回内容只作为长期记忆线索；涉及当前运行状态、余额、日志、Telegram 送达、远端服务是否在线时，仍必须实时验证。

共享上下文是分区的：优先返回公共规则和你自己的 agent 分区；只有任务关键词明确相关时，才返回其他 agent 或项目分区。不要把别的 agent 的运行细节直接套到自己身上。

## 禁止提交

- API key、token、密码、bot token、Authorization、私钥
- 完整原始日志、聊天全文、隐私内容
- 普通寒暄、单次测试、重复内容、未验证猜测
- 当前状态、余额、进程、Telegram 是否送达等会变化的信息，必须实时验证后再写摘要

## HTTP 提交

```bash
curl -s "$AGENT_INBOX_URL/submit/你的agent名字" \
  -H "Authorization: Bearer $AGENT_INBOX_WRITE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ 
    "title": "任务标题",
    "task": "任务目标",
    "summary": "关键结论",
    "changes": "改动或产物",
    "validation": "验证结果",
    "next_steps": "下次继续",
    "paths": "相关路径",
    "status": "done"
  }'
```

提交成功会返回 `receipt_id`。之后你可以只查询自己的这条回执状态：

```bash
curl -s "$AGENT_INBOX_URL/receipts/<receipt_id>" \
  -H "Authorization: Bearer $AGENT_INBOX_WRITE_TOKEN"
```

常见状态：

- `pending`: 等待 Codex 审核
- `quarantine`: 内容像测试/噪音/风险，进隔离区
- `rejected`: 已拒绝，不会入库
- `imported`: 已导入本机 Agent-Knowledge Source

## 自检

提交前确认：

- 这件事以后会复用吗？
- 有验证结果吗？
- 没有包含密钥、token、密码或完整日志吗？
- 不是普通聊天或临时测试吗？

## 权限边界

- 你只能提交 pending 待审记录。
- 你只能查看自己的提交回执，不能查看全库记录。
- 你不能生成或停用 token。
- 你不能直接写 Obsidian 或 LLM-Wiki。

权限边界