Skip to navigation
Начало работы

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

Первый ящик с API Agent Inbox

Минимальный пример

pip install agentinbox

Получите API-ключ в консоли и задайте переменную окружения AGENTINBOX_API_KEY.

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

Шаблон для Cursor / Claude

Скопируйте один из блоков ниже в Cursor или Claude: в нём есть настройка, ссылки на API, обработка ошибок, лимиты и идемпотентность.

"""
Agent Inbox Python quickstart — copy into Cursor/Claude for instant setup.
Setup: pip install agentinbox python-dotenv. Set AGENTINBOX_API_KEY in .env.
Errors: SDK raises on 4xx/5xx. Inspect error.body.message or str(e).
Rate limit: 429 with Retry-After header. Implement exponential backoff for retries.
Idempotency: Pass client_id to inboxes.create() to safely retry without duplicates.
"""
import os
from dotenv import load_dotenv
from agentinbox import Agentinbox
load_dotenv()
client = Agentinbox(api_key=os.getenv("AGENTINBOX_API_KEY"))
inbox = client.inboxes.create(client_id="my-agent-inbox-v1")
try:
    client.inboxes.messages.send(
        inbox.inbox_id,
        to="recipient@example.com",
        subject="Hello from Agent Inbox",
        text="Plain text body",
        html="<p>HTML body</p>",
    )
except Exception as e:
    print(f"Send failed: {e}")
    raise
for msg in client.inboxes.messages.list(inbox.inbox_id, limit=10).messages:
    print(msg.subject, msg.extracted_text or msg.text)

Во входящих письмах доступны поля extracted_text и extracted_html — текст ответа без цитируемой истории.

Ниже — пошаговая установка SDK, ключ и первый ящик.

1

Откройте консоль Agent Inbox

Управляйте аккаунтом и API-ключами в консоли.

Открыть консоль

Зарегистрируйтесь или войдите и создайте API-ключ в панели.

2

Создайте API-ключ

Перейдите в раздел API Keys, создайте ключ и сохраните его. Добавьте в .env, например: AGENTINBOX_API_KEY=....

3

Установите SDK

pip install agentinbox python-dotenv
4

Создайте ящик и отправьте письмо

Создайте файл (например quickstart.py или quickstart.ts) по образцу ниже.

import os
from dotenv import load_dotenv
from agentinbox import Agentinbox
load_dotenv()
api_key = os.getenv("AGENTINBOX_API_KEY")
client = Agentinbox(api_key=api_key)
print("Creating inbox...")
inbox = client.inboxes.create()
print("Inbox created successfully!")
print(inbox)
client.inboxes.messages.send(
  inbox.inbox_id,
  to="your-email@example.com",
  subject="Hello from Agent Inbox!",
  text="This is my first email sent with the Agent Inbox API.",
)

Параметр domain при создании ящика необязателен. Свои домены настройте в консоли перед продакшеном.

5

Запустите код

python quickstart.py

В консоли должны появиться данные созданного ящика.

Дальше

Изучите автоответы, вложения, webhooks и WebSocket в остальной документации.

Вопросы? Напишите на info@patternautomation.com.