Agent

An Agent from superagentx.agent is a system or program that is initialized with specific goals and roles, enabling it to interact with a large language model (LLM) and use a predefined prompt template. It is designed to perform agent by following a set of instructions and can be customized with various parameters to adapt its behavior to different agent or workflows. Essentially, the agent acts as a flexible tool that can be fine-tuned to carry out specific functions based on the needs of the user.

Agent Parameters

Attribute	Parameters	Description
Goal	`goal`	The primary objective or goal that the engine is designed to achieve.
Role	`role`	The role or function that the engine will assume in its operations.
LLM Client	`llm`	Interface for communicating with the large language model (LLM).
Prompt Template	`prompt_template`	Defines the structure and format of prompts sent to the LLM using PromptTemplate.
Engines	`engines`	A list of engines (or lists of engines) that the engine can utilize. This allows for flexibility in processing and task execution based on different capabilities or configurations.
Agent ID (optional)	`agent_id`	A unique identifier for the engine. If not provided, a new UUID will be generated by default. Useful for tracking or referencing the engine in multi-engine environments.
Name (optional)	`name`	An optional name for the engine, providing a more friendly reference for display or logging purposes.
Description (optional)	`description`	An optional description that provides additional context or details about the engine’s purpose and capabilities.
Output Format (optional)	`output_format`	Specifies the desired format for the engine’s output. This can dictate how results are structured and presented.
Max Retry (optional)	`max_retry`	The maximum number of retry attempts for operations that may fail.Default is set to 5. This is particularly useful in scenarios where transient errors may occur, ensuring robust execution.

from superagentx.agent import Agent

ecom_agent = Agent(
        name='Ecom Agent',
        goal="Get me the best search results",
        role="You are the best product searcher",
        llm=llm_client,
        prompt_template=prompt_template,
        engines=[[amazon_engine, walmart_engine]],
        agent_id="ecom-id-1",
        description="""E-commerce enables buying and selling products online,
        providing customers with the convenience of shopping anytime, anywhere.
        It connects buyers and sellers through digital platforms, offering
        secure transactions and delivery.
        """,
        output_format="Generate as JSON format",
        max_retry=5
    )

Agent Configuration

Sequence

In sequence execution, engine(s) are performed one after another, with each engine(s) waiting for the previous one to finish before starting. This approach is simple but can be slow if engine(s) are independent.

from superagentx.agent import agent

agent = Agent(
    ...
    engines=[engine_1, engine_2, engine_3 ... engine_n],
    ...
)

# Engines execution will be in following order
# [engine_1, engine_2, engine_3 ... engine_n]

Alternate way of configure

from superagentx.agent import agent

agent = Agent(
    ...,
    ...
)

await agent.add(engine_1, engine_2, execute_type='SEQUENCE')
.
.
.
await agent.add(engine_3, engine_4, execute_type='SEQUENCE')
.
.

# Engines execution will be in following order
# [engine_1, engine_2, engine_3, engine_4]

Parallel

In parallel execution, engine(s) run at the same time, speeding up the process by utilizing multiple threads or processes.

from superagentx.agent import agent

agent = Agent(
    ...
    engines=[[engine_1, engine_2, engine_3 ... engine_n]],
    ...
)

# Engines execution will be in following order
# [[engine_1, engine_2, engine_3 ... engine_n]]

Alternate way of configure

from superagentx.agent import agent

agent = Agent(
    ...,
    ...
)

await agent.add(engine_1, engine_2, execute_type='PARALLEL')
.
.

await agent.add(engine_3, engine_4, execute_type='PARALLEL')
.
.

# Engines execution will be in following order
# [[agent_1, engine_2, engine_3, engine_4]]

Mixed with Sequence and Parallel

from superagentx.agent import agent

agent = Agent(
    ...
    engines=[engine_1, [engine_2, engine_3], engine_4 ... engine_n],
    ...
)

# Engines execution will be in following order
# [engine_1, [engine_2, engine_3], engine_4, ... engine_nm]]

Alternate way of configure

from superagentx.agent import agent

agent = Agent(
    ...,
    ...
)

await agent.add(engine_1, engine_2, execute_type='SEQUENCE')
.
.
.
await agent.add(engine_3, engine_4, execute_type='PARALLEL')
.
.

# Engines execution will be in following order
# [engine_1, engine_2, [engine_3, engine_4]]

Task Agent

In SuperAgentX, a task agent is a focused, self-contained component that executes a complete workflow from start to finish. It receives an input or trigger, applies decision logic, and uses SuperAgentX handlers and tools to interact with external systems such as APIs, databases, or messaging services. Task agents are typically asynchronous and event-driven, enabling reliable automation of monitoring, processing, and orchestration tasks with minimal human intervention.

    task_agent = Agent(engines=[engine])

Browser Agent

In SuperAgentX, a browser agent is a specialized agent designed to interact with web interfaces just like a human user. It can navigate pages, fill forms, click buttons, extract data, and handle multi-step web workflows using a controlled browser environment. Browser agents are used when APIs are unavailable or insufficient, enabling automated web actions such as scraping, verification, onboarding, and portal-based operations within a larger task workflow.

    browser_agent = Agent(
        name="Review & Pay Agent",
        role="Browser Payment Executor",
        goal="Review checkout and pay using credit card",
        llm=llm,
        human_approval=True,   # governance point
        prompt_template=browser_prompt,
        engines=[browser_engine],
        max_retry=2
    )

Get Started

Key Components

Pipe Interface

Handlers (Tools)

Agent Parameters

Agent Configuration

Sequence

Alternate way of configure

Parallel

Alternate way of configure

Mixed with Sequence and Parallel

Alternate way of configure

Task Agent

Browser Agent

​Agent Parameters

​Agent Configuration

​Sequence

​Alternate way of configure

​Parallel

​Alternate way of configure

​Mixed with Sequence and Parallel

​Alternate way of configure

​Task Agent

​Browser Agent

Agent Parameters

Agent Configuration

Sequence

Alternate way of configure

Parallel

Alternate way of configure

Mixed with Sequence and Parallel

Alternate way of configure

Task Agent

Browser Agent