Sotopia

这个 Agent 能做什么，适合哪些场景？

Sotopia 是 ICLR 2024 spotlight 论文对应的开源社交学习环境，让多个语言智能体在开放式社交场景中互动。它通过 sotopia 包与异步服务器（run_async_server）运行回合，支持用不同模型分别担任环境与两个角色智能体。数据可存入 Redis（默认后端）或本地 JSON 文件（~/.sotopia/data/），并提供 Hugging Face 上的数据集与在线 Demo。项目以 Python 库和可运行服务器形式交付，采用 MIT 许可。使用者需要自备 OpenAI 等模型 API 密钥并支付调用费用。

仓库提供 Python 包 sotopia，其中 sotopia.server.run_async_server 以异步方式驱动一个社交回合，通过 model_dict 为 env、agent1、agent2 分别指定模型（如 gpt-4、gpt-4o-mini），并用 sotopia.samplers 中的 UniformSampler 采样场景。运行结果按配置写入 Redis（SOTOPIA_STORAGE_BACKEND=redis，连接串 REDIS_OM_URL）或本地 JSON 目录（SOTOPIA_STORAGE_BACKEND=local）。安装后可用 uv run sotopia install 初始化环境，examples/minimalist_demo.py 提供最小可运行示例。论文中提出的评估指标用于衡量语言智能体的社交智能。

1. 研究社交智能评测的研究者：用 Sotopia 环境比较不同 LLM 作为社交智能体的表现。
2. 强化学习/多智能体实验者：把开放社交场景当作可扩展环境来测试策略。
3. 模型开发者：让 gpt-4 与环境交互、gpt-4o-mini 扮演角色，观察对话质量。
4. 教学或演示场景：借助 Hugging Face Demo 和示例脚本展示多智能体对话。
5. 想要自定义场景的工程师：在本地 JSON 后端上快速试验新环境与角色。

如何安装或部署这个 Agent？

推荐先创建虚拟环境并使用 uv：

pip install uv
uv sync --all-extras
uv run sotopia install

若使用默认 Redis 后端，用 Docker 启动 Redis：

docker run -d -p 6379:6379 redis/redis-stack-server:latest

在项目根目录创建 .env 并填写密钥与后端：

cat > .env << EOF
OPENAI_API_KEY=your_openai_key_here
SOTOPIA_STORAGE_BACKEND=local
# REDIS_OM_URL=redis://localhost:6379
EOF

如何使用这个 Agent？

环境变量需手动加载，uv 不会自动读取 .env。首次运行最小示例：

uv run --env-file .env python examples/minimalist_demo.py

也可以直接调用异步服务器并指定各角色模型：

import asyncio
from sotopia.samplers import UniformSampler
from sotopia.server import run_async_server

asyncio.run(
    run_async_server(
        model_dict={
            "env": "gpt-4",
            "agent1": "gpt-4o-mini",
            "agent2": "gpt-4o-mini",
        },
        sampler=UniformSampler(),
    )
)

注意：未安装任何数据集时，本地服务器无法运行。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

[![FARS 评测](https://followagents.com/badge/sotopia.svg?lang=zh)](https://followagents.com/zh/agents/sotopia)

<a href="https://followagents.com/zh/agents/sotopia"><img src="https://followagents.com/badge/sotopia.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v0.1.5 v0.1.5 Make redis optional 2025-12-07
   发布说明摘录

   * Feature/multi agent framework by @Keyu-He in https://github.com/sotopia-lab/sotopia/pull/329 * Fix custom/local model support bugs by @Keyu-He in https://github.com/sotopia-lab/sotopia/pull/338 * sotopia redis optional by @XuhuiZhou in https://github.com/sotopia-lab/sotopia/pull/341

   在 GitHub 查看 ↗
2. v0.1.4 2025-02-01
   发布说明摘录

   What's Changed * Update langchain requirement from <0.3.0,>=0.2.5 to >=0.2.5,<0.4.0 by @dependabot in https://github.com/sotopia-lab/sotopia/pull/236 * [Automated] Merge release into main by @ProKil in https://github.com/sotopia-lab/sotopia/pull/235 * update macos test runner as macos-latest by @ProKil in https://github.com/sotopia-lab/sotopia/pull/238 * feat(exp_eval): support tag for combo iteration by @lwaekfjlk in https://github.com/sotopia-lab/sotopia/pull/245 …

   在 GitHub 查看 ↗
3. v0.1.3 2025-01-08
   发布说明摘录

   What's Changed * UI update by @XuhuiZhou in https://github.com/sotopia-lab/sotopia/pull/273 Full Changelog: https://github.com/sotopia-lab/sotopia/compare/v0.1.2...v0.1.3

   在 GitHub 查看 ↗

常见问题