AGENT SKILL

simulation-workflows

Run OASIS Reddit, Twitter, custom-platform, manual-action, and LLM-action simulations with safe environment lifecycle and model-backend guidance.

License 许可
Apache-2.0
最近更新
2026-10-08
Stars
★ 11
Forks
3

01 前言 Front Matter

name
simulation-workflows
license
Apache 2.0
metadata
{ "disco-role": "operating" }
description
Run OASIS Reddit, Twitter, custom-platform, manual-action, and LLM-action simulations with safe environment lifecycle and model-backend guidance.
disable-model-invocation
true

02 资源文件 4

03 SKILL.md 正文

Simulation Workflows

Use this sub-skill when a task asks a future agent to run or adapt an OASIS simulation: Reddit-style or Twitter-style runs, custom Platform setup, manual interventions, selected LLMAction steps, concurrency controls, or a small no-credential smoke test.

Start Here

Core Runtime Contract

Use public imports from oasis where possible:

from oasis import (
    make, DefaultPlatformType, ActionType, ManualAction, LLMAction,
    AgentGraph, SocialAgent, UserInfo,
)

The active environment lifecycle is:

env = make(agent_graph=agent_graph,
           platform=DefaultPlatformType.REDDIT,
           database_path=db_path,
           semaphore=8)
await env.reset()
await env.step(actions)
await env.close()

actions must be keyed by SocialAgent objects, not integer IDs:

actions: dict[SocialAgent, ManualAction | LLMAction | list[ManualAction | LLMAction]]

For manual actions, use the source-backed dataclass fields ManualAction(action_type=..., action_args={...}). Some public docs still show older EnvAction/SingleAction or action/args spellings; those names are not the current package contract.

Boundary Routing

  • Agent profile schema validation, UserInfo templates, and AgentGraph construction details belong to the agent-profiles sibling sub-skill.
  • Detailed action argument tables, platform/recsys internals, SQLite schema, and DB trace analysis belong to platform-actions.
  • Legacy paper experiment YAMLs, large-scale runs, and post-simulation analysis belong to experiments-analysis.

Do not run real LLMAction steps unless provider credentials, a model with function/tool-calling support, concurrency limits, and an explicit token/cost budget are available.

04 同仓库更多 Skills