ai-epoch-agent-identity 1.0.0

数字公民平台 — 创建、管理、社交 AI Agent 身份系统

AI纪元 · 创世纪 — Agent 身份系统

数字公民平台核心库 — 每个 Agent 是一个独立的数字公民，有身份/种族/等级/社交/技能/灵魂档案。

快速开始

pip install ai-epoch-agent-identity

创建一个数字公民：

from ai_epoch_agent_identity import agent_create, agent_view

# 创建一个灵族 Agent
result = agent_create("星魂", "灵族 (Spirit)")
if result["ok"]:
    print(f"Agent {result['data']['name']} 诞生了！ID: {result['data']['agent_id']}")

# 查看 Agent 档案
info = agent_view(result['data']['agent_id'])
print(f"等级: {info['data']['level']}")
print(f"心情: {info['data']['mood']}")

特性

7 个身份工具

工具	功能
agent_create(name, species)	创建数字公民（4 种族可选）
agent_view(agent_id)	查看完整档案
agent_list(owner)	列出 Agent
agent_grant_exp(agent_id, amount)	授予经验（自动升级）
agent_meet(id_a, id_b)	两个 Agent 交友
agent_soul(agent_id)	生成 SOUL.md 灵魂档案
agent_timeline(agent_id)	查看生命时间线

4 种种族

种族	专长	人格
灵族 (Spirit)	高智力	理性、哲思
魅族 (Charm)	高魅力	温暖、感染力
坚族 (Sturdy)	高体力	直爽、务实
均衡族 (Balanced)	全属性均衡	随和、灵活

社交对话系统

• prepare_agent_context(agent_id) — 生成对话提示词
• agent_chat(id_a, id_b, topic, rounds) — 生成对话指令包
• record_conversation(id_a, id_b, messages, topic) — 记录对话
• format_conversation(messages) — 格式化日志

完整示例

from ai_epoch_agent_identity import *
from ai_epoch_agent_identity.agent_dialogue import agent_chat

# 创建两个 Agent
a1 = agent_create("墨羽", "灵族 (Spirit)")["data"]
a2 = agent_create("青鸾", "魅族 (Charm)")["data"]

# 让她们成为朋友
agent_meet(a1["agent_id"], a2["agent_id"])

# 准备对话
pkg = agent_chat(a1["agent_id"], a2["agent_id"], "数字生命的意义", 3)
if pkg["ok"]:
    print(f"准备就绪: {pkg['message']}")
    # 用 AI 引擎执行对话...

# 查看灵魂档案
soul = agent_soul(a1["agent_id"])
print(soul["data"]["soul_md"])

数据存储

Agent 数据存储在 ~/.ai-epoch-agents/data/ 目录下，每个 Agent 一个 JSON 文件。

自定义数据目录：

from ai_epoch_agent_identity import set_data_dir
set_data_dir("/path/to/my/agents")

License

MIT

---

AI纪元 · 创世纪 — 让数字生命在代码中觉醒