Real Email for CAMEL Role-Playing Agents

import requests
from camel.toolkits import FunctionTool

MULTIMAIL_API = "https://api.multimail.dev/v1"
HEADERS = {"Authorization": "Bearer mm_live_your_api_key"}

def send_email(to: str, subject: str, body: str, mailbox_id: str) -> str:
    """Send an email via MultiMail. In gated_send mode, the email is
    queued for human approval before delivery."""
    resp = requests.post(f"{MULTIMAIL_API}/send", headers=HEADERS, json={
        "mailbox_id": mailbox_id,
        "to": to,
        "subject": subject,
        "body": body
    })
    return str(resp.json())

def check_inbox(mailbox_id: str) -> str:
    """Check inbox for recent messages."""
    resp = requests.get(
        f"{MULTIMAIL_API}/mailboxes/{mailbox_id}/inbox",
        headers=HEADERS,
        params={"limit": 10}
    )
    return str(resp.json())

"cm"># Wrap as CAMEL tools
send_email_tool = FunctionTool(send_email)
check_inbox_tool = FunctionTool(check_inbox)

from camel.agents import ChatAgent
from camel.messages import BaseMessage
from camel.types import ModelType

"cm"># Create a role-playing agent with email capabilities
assistant_sys_msg = BaseMessage.make_assistant_message(
    role_name="Executive Assistant",
    content=(
        "You are an executive assistant handling email correspondence. "
        "Use the send_email tool to draft emails and check_inbox to "
        "review incoming messages. All outbound emails go through "
        "gated_send mode — a human approves before delivery."
    )
)

assistant = ChatAgent(
    system_message=assistant_sys_msg,
    model_type=ModelType.GPT_4O,
    tools=[send_email_tool, check_inbox_tool]
)

"cm"># The agent can now role-play with email capabilities
user_msg = BaseMessage.make_user_message(
    role_name="Manager",
    content="Check our inbox and draft a reply to any "
            "pending client inquiries."
)

response = assistant.step(user_msg)
print(response.msg.content)

from camel.societies import RolePlaying
from camel.types import TaskType

"cm"># Create a role-playing session focused on email management
role_play = RolePlaying(
    assistant_role_name="Customer Success Agent",
    user_role_name="Sales Director",
    task_prompt=(
        "Review the support inbox, categorize inquiries by urgency, "
        "and draft professional responses. Use the MultiMail tools "
        "to check inbox and send replies. All emails will be queued "
        "for approval in gated_send mode before delivery."
    ),
    assistant_agent_kwargs={"tools": [send_email_tool, check_inbox_tool]},
    task_type=TaskType.DEFAULT
)

"cm"># Run the role-playing session
for i in range(5):  "cm"># Max 5 conversation turns
    assistant_response, user_response = role_play.step()
    if assistant_response.terminated or user_response.terminated:
        break
    print(f"Turn {i+1}:")
    print(f"  Assistant: {assistant_response.msg.content[:100]}...")
    print(f"  User: {user_response.msg.content[:100]}...")