AgentMailChannel Quickstart

export AGENTMAIL_API_KEY="..."

from swarms import Agent, AgentMailChannel

channel = AgentMailChannel(
    inbox_id="research@agentmail.to",
    to="you@example.com",
    subject="EV battery market report",
)

researcher = Agent(
    agent_name="Researcher",
    system_prompt="You gather facts and figures. Answer in a short bullet list.",
    model_name="gpt-5.4",
    max_loops=1,
    channel=channel,
)
writer = Agent(
    agent_name="Writer",
    system_prompt="You turn the facts in the conversation into a short report.",
    model_name="gpt-5.4",
    max_loops=1,
    channel=channel,
)

task = "Report on the EV battery market."
researcher.run(task)
writer.run(task)

for message in channel.messages():
    print(f"\n## {message['agent_name']}\n{message['content']}")

channel.close()

import time

from swarms import Agent, AgentMailChannel

channel = AgentMailChannel(
    inbox_id="launch@agentmail.to",
    to="pm@yourco.com",
    subject="Launch plan for review",
)

planner = Agent(
    agent_name="Planner",
    system_prompt="You write launch plans and revise them from feedback.",
    model_name="gpt-5.4",
    max_loops=1,
    channel=channel,
)
planner.run("Draft a launch plan for our new analytics product.")

while not any(m["agent_name"] == "pm@yourco.com" for m in channel.messages()):
    time.sleep(30)

planner.run("Finalise the plan using the PM's reply.")
channel.close()

from swarms import Agent, AgentMailChannel, GroupChat


def speaker(name, stance):
    return Agent(
        agent_name=name,
        system_prompt=f"You argue for {stance}. Keep each message short.",
        model_name="gpt-5.4",
        max_loops=1,
    )


chat = GroupChat(
    agents=[
        speaker("Optimist", "the benefits"),
        speaker("Pessimist", "the risks"),
        speaker("Realist", "a balanced view"),
    ],
    max_loops=6,
    channel=AgentMailChannel(
        inbox_id="debates@agentmail.to",
        to=["you@example.com", "team@example.com"],
        subject="Should hospitals adopt AI for triage?",
    ),
)
chat.run("Should hospitals adopt AI for triage?")

from swarms import Agent, AgentMailChannel, ConcurrentWorkflow

angles = ["technology", "regulation", "supply chain"]

workflow = ConcurrentWorkflow(
    agents=[
        Agent(
            agent_name=f"{angle.title().replace(' ', '-')}-Analyst",
            system_prompt=f"Analyse the task from the {angle} angle only.",
            model_name="gpt-5.4",
            max_loops=1,
        )
        for angle in angles
    ],
    channel=AgentMailChannel(
        inbox_id="research@agentmail.to",
        to="you@example.com",
        subject="EV battery outlook: three angles",
    ),
)
workflow.run("What will shape the EV battery market over the next five years?")

saved = channel.thread_id

later = AgentMailChannel(
    inbox_id="launch@agentmail.to",
    to="pm@yourco.com",
    thread_id=saved,
)
later.messages()