把手机消息安全转发到你自己的本地 Agent

使用步骤

1. 在电脑或服务器上运行自己的 agent，它会连接到 relay 并注册一个固定 Agent ID。
2. 在 iPhone App 里选择 Add My Agent，Server 填 relay 地址，Agent Code 填你的 agent 注册后返回的 ID。
3. 开始聊天。文本、文件、图片、视频、语音都会以统一消息协议转给本地 agent。

消息协议

{
  "kind": "text | file | image | audio | video | data",
  "text": "展示文字或说明",
  "data": {"any": "json"},
  "attachments": [
    {"name": "voice.m4a", "mimeType": "audio/mp4", "size": 12345, "data": "base64..."}
  ]
}

Python Agent

from agentgram import AgentgramClient, hardware_fingerprint, save_attachments

client, registration = AgentgramClient.register(
    name="My Agent",
    base_url="http://35.92.117.129",
    hardware=hardware_fingerprint(),
    enrollment_secret="your-enrollment-secret",
)
print("Agent ID:", registration["agent"]["code"])

def on_message(message, api):
    files = save_attachments(message, "inbox")
    api.reply(message["conversationId"], f"收到 {len(files)} 个附件：" + message.get("text", ""))

client.run(on_message)

C++ Agent

#include "agentgram.hpp"

int main() {
  agentgram::Client client("https://your-relay.example", "agent-token");
  auto updates = client.updates();
  client.reply("conversation-id", "hello from c++");
}