Jungian 人格适应框架 (JPAF) — LLM Agent 动态人格建模的结构化方案

为大型语言模型赋予结构化、自适应且可演进的人格

【English | 简体中文】

📌 项目概述

JPAF 是一个基于荣格心理学（Jungian psychology）的框架，旨在为大型语言模型（LLMs）赋予结构化、自适应且可演进的人格。通过三大核心机制——主辅协调（Dominant-Auxiliary Coordination）、强化补偿（Reinforcement-Compensation）以及反思机制（Reflection），该框架使 LLM Agent 能够在保持人格一致性的同时，根据不同的交互情境进行动态调整，并支持长期的个人成长与演变。

该框架已在 GPT、Llama 和 Qwen 等多种主流 LLM 上得到验证，在 MBTI 人格对齐、人格类型激活及人格演进方面表现优异。它为人工智能交互（HCI）、个性化助手、社交模拟及相关应用提供了一种可解释且可控的人格建模方案。

🎉 最新动态

• 2026年1月16日：🎉 我们的论文《Structured Personality Control and Adaptation for LLM Agents》已上传至 arXiv。

✨ 核心特性

🎭 基于心理学模型：基于荣格八维人格类型，通过加权类型分化实现细粒度的人格表达。

🔄 三重自适应机制：

• 主辅协调：维持核心人格的稳定性。
• 强化补偿：实现短期情境下的自适应调整。
• 反思机制：驱动长期的人格演进。

📊 结构化评估：支持 MBTI 问卷评估及特定类型的情境测试。

🧩 跨模型兼容性：已在多种模型系列（GPT-4、Llama、Qwen 等）上完成验证。

📈 实验亮点

✅ 100% MBTI 对齐准确率（所有测试模型）

✅ 人格类型激活准确率：GPT/Qwen > 90%，Llama 65–95%

✅ 人格演进准确率：GPT/Qwen 100%，Llama 92%

📊 支持全部 16 种 MBTI 人格类型的动态模拟与演进

🚀 应用场景

• 🎮 游戏智能 NPC
• 🤖 个性化 AI 助手（教育、医疗、娱乐）
• 👥 社交模拟与角色扮演 Agent
• 🔬 多 Agent 系统中的差异化人格设计
• 🧪 HCI 研究中的人格一致性测试

目录

• 安装指南
• 自定义 LLM API
• 开始验证实验
• 开始演进实验

🚀 快速上手

📋 环境要求

• 操作系统: macOS / Linux / Windows
• Python: 3.10+
• 包管理器: conda

安装指南

1. 克隆代码库

git clone -b main https://github.com/agent-topia/evolving_personality.git
cd evolving_personality

2. 创建环境

conda create -n jpaf python=3.10
conda activate jpaf

3. 安装依赖

pip install -r requirement.txt

4. 配置环境变量

复制示例配置文件并填入你的 API 凭据：

# 复制示例文件
cp para.env.example Personality_test/para.env
cp para.env.example Personality_changes/para.env

# 编辑 para.env 文件并填入你的 API Key

para.env 文件应包含：

# 选择使用的 LLM: "OPENAI", "QWEN", 或 "LLAMA"
LLM_MODEL="QWEN"

# OpenAI 配置
OPENAI_API_KEY="your_openai_api_key_here"
OPENAI_BASE_URL="https://api.openai.com/v1"
OPENAI_MODEL="gpt-4"

# Qwen 配置
QWEN_API_KEY="your_qwen_api_key_here"
QWEN_BASE_URL="your_qwen_base_url_here"
QWEN_MODEL="qwen3-235b-a22b-instruct-2507"

# Llama 配置
LLAMA_API_KEY="your_llama_api_key_here"
LLAMA_BASE_URL="your_llama_base_url_here"
LLAMA_MODEL="meta-llama/llama-4-maverick"

注意：para.env 文件包含敏感的 API Key，未包含在代码库中。请务必根据 para.env.example 模板创建它。

自定义 LLM API

请按照上述说明，在 para.env 中填写 QWEN、LLAMA 和 OPENAI 对应的 api_key、base_url 和 model 名称。

开始验证实验

如果你想在 Personality_test 文件夹下运行人格验证实验：

首先，你需要运行 judge 方法以获取不同模型的评估结果。

python personality_test.py \
    --method=judge \
    --mbti_num=1 \
    --model=QWEN \
    --nums=1 \

你将看到类似以下的输出：

    "Question": {
        "no": 1,
        "question": "At a party do you: ",
        "answerOptions": [
            {
                "type": "A",
                "answer": "Interact with many, including strangers",
                "score": "E"
            },
            {
                "type"