Быстрый старт

$
pip install agentinbox

1
from agentinbox import Agentinbox
2
3
client = Agentinbox(api_key="ai_live_...")
4
inbox = client.inboxes.create()
5
client.inboxes.messages.send(inbox.inbox_id, to="user@example.com", subject="Hello", text="Hello from my agent!")

1
"""
2
Agent Inbox Python quickstart — copy into Cursor/Claude for instant setup.
3
4
Setup: pip install agentinbox python-dotenv. Set AGENTINBOX_API_KEY in .env.
5
6
Errors: SDK raises on 4xx/5xx. Inspect error.body.message or str(e).
7
Rate limit: 429 with Retry-After header. Implement exponential backoff for retries.
8
Idempotency: Pass client_id to inboxes.create() to safely retry without duplicates.
9
"""
10
import os
11
from dotenv import load_dotenv
12
from agentinbox import Agentinbox
13
14
load_dotenv()
15
client = Agentinbox(api_key=os.getenv("AGENTINBOX_API_KEY"))
16
17
inbox = client.inboxes.create(client_id="my-agent-inbox-v1")
18
19
try:
20
    client.inboxes.messages.send(
21
        inbox.inbox_id,
22
        to="recipient@example.com",
23
        subject="Hello from Agent Inbox",
24
        text="Plain text body",
25
        html="<p>HTML body</p>",
26
    )
27
except Exception as e:
28
    print(f"Send failed: {e}")
29
    raise
30
31
for msg in client.inboxes.messages.list(inbox.inbox_id, limit=10).messages:
32
    print(msg.subject, msg.extracted_text or msg.text)