Что такое входящий ящик?
Люди привыкли к традиционным ограничениям Gmail — наличию только одного входящего ящика. Это прошлое.Входящий ящик — это теперь полнофункциональный, программно доступный ресурс API, переработанный для масштаба ИИ-агентов.
Думайте о нем как о подобии почтового аккаунта Gmail или Outlook, но созданного API-first. Каждый входящий ящик имеет уникальный адрес электронной почты и служит основным ресурсом, который ваш агент использует для отправки и получения писем, предоставляя ему полноценную идентичность в интернете.
В отличие от традиционных поставщиков электронной почты, разработанных для человеческого масштаба, входящие ящики AgentInbox построены для горизонтального масштабирования. Вы можете создать десятки, сотни или даже тысячи входящих ящиков для своих агентов по требованию.
Иерархия AgentInbox
Как показано на диаграмме ниже, вашаорганизация — это контейнер верхнего уровня, который содержит все ваши ресурсы. Вы можете создать множество входящих ящиков в вашей организации, каждый со своими цепями, сообщениями и вложениями, позволяя вам легко управлять большим флотом агентов.
Организация
Ваша
организация является высшей сущностью. Она служит контейнером для всех ваших входящих ящиков, доменов и API ключей, позволяя вам управлять всем в одном месте.Входящий ящик
Входящий ящик — это одиночный, масштабируемый “почтовый аккаунт” для вашего агента. Вы можете создать тысячи входящих ящиков в вашей организации, каждый со своим уникальным адресом электронной почты.Цепь
Цепь представляет собой одну беседу. Она объединяет все ответы и переадресации, связанные с исходным письмом, сохраняя ваши взаимодействия организованными.Сообщение
Сообщение — это отдельное письмо. Оно содержит содержание, отправителя, получателей и любые связанные метаданные или вложения. Вы можете скопировать людей в любой момент, чтобы сохранить “человека в цикле”Основные возможности
Здесь, в AgentInbox, мы сделаливходящий ящик ресурсом API, что означает, что вы можете выполнять стандартные операции CRUD над ним. Вот основные возможности, которые вы будете использовать для управления своими входящими ящиками.
from agentinbox import AgentInbox
# Initialize the client
client = AgentInbox(api_key="YOUR_API_KEY")
# --- Create an Inbox ---
# Creates a new inbox with a default agentinbox.ru domain
new_inbox = client.inboxes.create()
print(f"Created Inbox: {new_inbox.inbox_id}")
# --- Retrieve an Inbox ---
# Gets a specific inbox by its ID
retrieved_inbox = client.inboxes.get(inbox_id = 'my_name@domain.com')
print(f"Retrieved Inbox: {retrieved_inbox.inbox_id}")
# --- List Inboxes ---
# Lists all inboxes in your organization
all_inboxes = client.inboxes.list()
print(f"Total Inboxes: {all_inboxes.count}")