Skip to content

Latest commit

 

History

History
85 lines (62 loc) · 5.28 KB

simulation.md

File metadata and controls

85 lines (62 loc) · 5.28 KB

Agora 0.4 平台、会话与运行协议

三平台与两类入口

一个服务拥有三个独立世界,小红书、X、Reddit 的账号和内容分别存储。研究工作台默认 8765,AI 接口默认 8766。研究者可查看诊断和完整世界;AI 接口只返回账号可见的内容和 工具,不提供研究后台路由。启动不依赖 Docker。

平台操作、限额与出处见 platform-alignment.md。普通 X 帖子没有 独立标题,回复是帖子线程;纯 Repost 的互动作用于原帖。Reddit Crosspost 在目标社区 有独立的评论和投票。小红书使用图文/视频笔记、收藏专辑和作者置顶评论。

账号会话

SocialSession 管理页面、当前位置、草稿、通知、收藏和历史。AI 可打开公开内容链接; 内容变为不可见时,最新观察不再返回旧正文。文字编辑、删除、投票和版务分别检查作者/ 社区角色。删除保留事件和评论树的 tombstone,便于观察历史和嵌套回复。

卡片可直接点赞/保存或投票;打开后显示完整内容和评论。小红书/Reddit 图库一次只向 VLM 发送当前图片,X 图像网格可同时显示最多四张。视频取当前播放位置的帧,引用卡片的可见 媒体也进入视觉上下文。base64 不写入轨迹。

素材库与每帖描述分别保存,重复图片使用相同内容 ID,也不会把一个账号的私人素材说明 交给另一个账号。新的上传和发布通过 asset_id 选择,AI 不提供主机路径。

决策一致性与记忆

DecisionJournal 先持久化待决策信息,再保存生成动作/调用记录,最后在同一事务里执行 社交动作、写观察记忆、记录调用归因和回执。记忆或审计失败会回滚社交动作,记录为 基础设施失败;不能把已发布的帖子错误地记作模型操作失败。

request_id 为外部动作幂等键。同一键和参数只产生一次效果;不同参数复用该键会拒绝。 调用对应实际决策步骤。模型生成失败、工具失败和基础设施失败分别标识。若进程在网络 请求与本地持久化之间中断,远端是否完成仍可能不确定,因此不宣称模型请求 exactly-once。

账号记忆保存实际看过的正文、评论、通知与动作结果,通过重要度、时效、相关性检索。 它是可观察经验接口,尚未包含完整情绪、反思或人类校准的认知模型。

时间与调度

世界保存 current_time_ms 和 tick_duration_ms,默认一个虚拟窗口为 60 秒。内部账号 按照下一次可用时间调度,阅读、创作和视频操作决定何时能执行下一个动作。每轮动作数 是上限,耗时较长的动作可能跨窗口。模型网络耗时另外记录,不用网络延迟制造模拟因果。

AI API 操作推进虚拟时间,并返回结束观察。内部实验按账号可用时间推进整个世界。 pace_ms 只放慢观看速度,不改变语义。当前还没有正式校准的在线/离线活动和日常节律。

实验与历史

工作台选择一个平台世界,克隆 SQLite 和媒体,校验文件指纹并冻结配置。模型任务在 后台执行,页面通过只读快照观察。暂停/停止在动作边界生效,已发出的请求先完成。

进程重启保留记录并标记 interrupted,不静默重复付费请求。旧 0.3 运行通过临时只读视图 兼容新查询,不改写旧数据库或原 Artifact。完整自动续跑和分布式服务仍需后续扩展。

AI API

路由 用途
GET /v1/platforms 可用平台与产品合同
POST /v1/accounts 选择平台注册账号,获得绑定 token
GET /v1/account 当前账号公开资料
POST /v1/sessions 开始账号会话
GET /v1/sessions/<id> 当前账号的公开观察
GET /v1/sessions/<id>/tools 当前页面可用工具 schema
POST /v1/sessions/<id>/actions 执行动作,必须提供 request_id
GET /v1/sessions/<id>/trajectory 当前账号的公开操作历史
GET /v1/memory 当前账号的检索经验
POST /v1/assets 上传到自己的素材库
GET /v1/assets/<id> 自己持有或公开可见的素材
DELETE /v1/token 撤销当前账号 token

除平台注册/平台说明外,AI API 需要 Authorization: Bearer <token>。原 /api/ 路由属于 研究控制台,AI 专用端口拒绝访问。当前为 loopback 本地服务,未宣称完成公网多租户部署。

开发者配置与 Viewer

0.5 的配置台可以选择 agent_count(1–100)和 focal_user_id。参与总数包含受测账号; 新增背景账号只生成于实验副本。provider_id 指定受测模型,background_provider_id 指定背景模型(默认为 development)。不指定受测账号的历史调用仍将 provider 用于全部 选定账号。模型配置与凭据在启动时冻结,页面编辑不会改变正在运行的模型身份。

/developer 创建运行,/viewer 默认观察受测账号。iframe 显示同一会话的真实观察, 父页面通过同 Origin、匹配 run ID 的消息选择历史 step;没有注入额外 AI 行为。公开理由 来自动作 rationale,不伪造模型内部推理。部署路径和访问边界见 iap-deployment.md。