Ящики (инбоксы)
Ящики (инбоксы)
Основа идентичности и коммуникации вашего агента.
Что такое ящик (Inbox)?
Привычно думать об ограничениях классической почты — один ящик на человека. Это в прошлом.
Inbox — это полноценный программно доступный ресурс API, переработанный под масштаб AI-агентов.
Представьте что-то вроде аккаунта Gmail или Outlook, но изначально построенного вокруг API. У каждого Inbox свой уникальный адрес электронной почты; это главный ресурс, через который агент отправляет и получает письма и получает полноценную идентичность в интернете.
В отличие от классических провайдеров, рассчитанных на людей, ящики Agent Inbox масштабируются горизонтально. Вы можете по запросу создавать десятки, сотни или тысячи Inboxes для своих агентов.
Между прочим: вместо 1000 писем из одного Inbox отправка по 10 писем из 100
Inboxes улучшает доставляемость. Подробнее об оптимизации — здесь
Иерархия Agent Inbox
Как показано на схеме ниже, ваша organization — контейвер верхнего уровня для всех ресурсов. Внутри неё вы создаёте множество Inboxes, у каждого свои Threads, Messages и Attachments, чтобы управлять большим парком агентов без лишней суеты.
Организация
Ваша organization — сущность самого высокого уровня. Она объединяет все
ваши Inboxes, Domains и API-ключи, чтобы управлять всем из одного места.
Ящик (Inbox)
Inbox — это один масштабируемый «почтовый аккаунт» для агента. В организации
можно создать тысячи Inboxes, у каждого — свой уникальный адрес.
Цепочка (Thread)
Thread — одна беседа. В ней сгруппированы все ответы и пересылки,
связанные с исходным письмом, чтобы переписка оставалась упорядоченной.
Основные возможности
В Agent Inbox Inbox — это ресурс API: доступны стандартные CRUD-операции. Ниже — ключевые сценарии управления Inboxes.
При создании Inbox поля username и domain необязательны. Если их не
указать, Agent Inbox сгенерирует уникальный адрес на нашем домене по умолчанию.
Подробнее — в руководстве по управлению доменами.
API-ключи с областью ящика
Можно создавать API-ключи, ограниченные одним ящиком. Такой ключ видит только цепочки, сообщения и черновики этого ящика. Это удобно, когда агенту или интеграции нужен минимум доступа.
Подробнее о ключах с ограниченной областью — в руководстве по мультитенантности.
Копировать в Cursor / Claude
Скопируйте один из блоков ниже в Cursor или Claude, чтобы за один раз передать полное описание API ящиков.
