​
marvin.agents.actor

​
Constants

​
T

T = TypeVar('T')

​
Classes

​
Actor

class Actor(name: str, instructions: str | None = None, description: str | None = None, verbose: bool = False, prompt: str | Path)

Methods:

  • end_turn 
    def end_turn(self, thread: Thread, result: AgentRunResult)
    Called when the actor ends its turn.
  • friendly_name 
    def friendly_name(self, verbose: bool = True) -> str
  • get_agentlet 
    def get_agentlet(self, tools: Sequence[Callable[..., Any]], end_turn_tools: Sequence[EndTurn], active_mcp_servers: list[MCPServer] | None = None) -> pydantic_ai.Agent[Any, Any]
  • get_current 
    def get_current(cls) -> Optional[Actor]
    Get the current actor from context.
  • get_end_turn_tools 
    def get_end_turn_tools(self) -> list[EndTurn]
    A list of EndTurn tools that this actor can use to end its turn.
  • get_memories 
    def get_memories(self) -> list[Memory]
    A list of memories that this actor can use during its turn.
  • get_prompt 
    def get_prompt(self) -> str
  • get_tools 
    def get_tools(self) -> list[Callable[..., Any]]
    A list of tools that this actor can use during its turn.
  • run 
    def run(self, instructions: str | Sequence[UserContent], result_type: type[T] = str, tools: list[Callable[..., Any]] = [], thread: Thread | str | None = None, handlers: list[Handler | AsyncHandler] | None = None, raise_on_failure: bool = True, **kwargs: Any = {}) -> Any
  • run_async 
    def run_async(self, instructions: str | Sequence[UserContent], result_type: type[T] = str, tools: list[Callable[..., Any]] = [], thread: Thread | str | None = None, handlers: list[Handler | AsyncHandler] | None = None, raise_on_failure: bool = True, **kwargs: Any = {}) -> Any
  • say 
    def say(self, message: str, instructions: str | None = None, thread: Thread | str | None = None)
    Responds to a user message in a conversational way.
  • say_async 
    def say_async(self, message: str, instructions: str | None = None, thread: Thread | str | None = None)
    Responds to a user message in a conversational way.
  • start_turn 
    def start_turn(self, thread: Thread)
    Called when the actor starts its turn.

​
Functions

​
get_current_actor

def get_current_actor() -> Actor | None

Get the currently active actor from context.

Returns: The current Actor instance or None if no actor is active.

Parent Module: agents