agent-lists

name	agent-lists
description	Patterns for creating EDSL AgentLists from various sources: lists, CSV, Excel, DataFrame, and programmatic combinations.

AgentList Creation Patterns

IMPORTANT: name is a reserved keyword for Agent(). Use Agent(name='...', traits={...}) — never put name inside the traits dict. Putting name in traits raises AgentNameError.

IMPORTANT: instructions is a parameter of AgentList.from_source() only — it is NOT accepted by the AgentList() constructor. To add instructions when building an AgentList manually, set instruction on each Agent: Agent(traits={...}, instruction="Answer as if...").

IMPORTANT: All agents in an AgentList must have the same instruction string. EDSL raises AgentListError if any agent's instruction differs. Use traits for individuality (persona, background, demographics) and a single shared instruction for behavioral guidance. If agents don't need special instructions, omit instruction entirely.

From a List of Agents

from edsl import Agent, AgentList

agent1 = Agent(name="Alice", traits={"age": 25, "occupation": "teacher"})
agent2 = Agent(traits={: , : })
agents = AgentList([agent1, agent2])