Skip to navigation

Онбординг агента

Всё необходимое, чтобы подключить AI-агента к Agent Inbox

Если вы разрабатываете с помощью ИИ, Agent Inbox даёт несколько ресурсов, которые упрощают работу.

Предварительное условие: API-ключ

Нужен человек, который создаст аккаунт Agent Inbox на agentinbox-ru.vercel.app/. В кабинете создайте API-ключ. С ним агент сможет создавать ящики, отправлять и получать почту, вести треды и не только.

Бесплатный тариф Agent Inbox пока отсутствует.

MCP-сервер Agent Inbox

MCP (Model Context Protocol) — открытый протокол, который стандартизирует, как приложения передают контекст LLM. MCP-сервер Agent Inbox даёт агенту инструменты для ящиков, отправки писем, тредов и других операций.

Настройка

Добавьте в конфигурацию MCP-клиента (Claude Code, Cursor, Codex и т.д.):

{
"mcpServers": {
"Agent Inbox": {
"command": "npx",
"args": ["-y", "agentinbox-mcp"],
"env": {
"AGENTINBOX_API_KEY": "YOUR_API_KEY"
}
}
}
}

Можно включить только нужные инструменты через аргумент --tools:

{
"mcpServers": {
"Agent Inbox": {
"command": "npx",
"args": ["-y", "agentinbox-mcp", "--tools", "get_message,send_message,reply_to_message"],
"env": {
"AGENTINBOX_API_KEY": "YOUR_API_KEY"
}
}
}
}

Доступные MCP-инструменты

ИнструментОписание
create_inboxСоздать новый почтовый ящик для агента
list_inboxesСписок всех ящиков в аккаунте
get_inboxДетали конкретного ящика
delete_inboxУдалить ящик
send_messageОтправить письмо из ящика агента
reply_to_messageОтветить на письмо в треде
forward_messageПереслать письмо
update_messageОбновить метки или статус сообщения
list_threadsСписок тредов в ящике
get_threadПолный тред с сообщениями
get_attachmentСкачать вложение из письма

Документация Agent Inbox для агентов

Актуальную документацию для агента можно дать тремя способами:

  1. Полный индекс документации Структурированный список страниц с описаниями:
    https://agentinbox.space/llms.txt
  2. Вся документация одним файлом Все страницы склеены в один файл для полного контекста:
    https://agentinbox.space/llms-full.txt
  3. Markdown-версия любой страницы К URL страницы добавьте .md:
    https://agentinbox.space/quickstart.md

Навыки Agent Inbox

Навыки дают агентам специализированные знания для задач. Установите навык Agent Inbox, чтобы ассистент по коду получил полный набор почтовых возможностей:

Claude Code

claude-code skills install agentinbox/agentinbox-skills/agentinbox

Cursor

cursor skills install agentinbox/agentinbox-skills/agentinbox

Codex

codex skills install agentinbox/agentinbox-skills/agentinbox

Ручная установка

git clone https://github.com/agentinbox/agentinbox-skills.git ~/.skills/agentinbox

Затем задайте API-ключ:

export AGENTINBOX_API_KEY="your-api-key-here"

Быстрый старт для агентов

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

from agentinbox import Agentinbox
client = Agentinbox(api_key="am_...")
inbox = client.inboxes.create(display_name="My AI Agent")
print(f"Agent email: {inbox.inbox_id}")
# Send an email
client.inboxes.messages.send(
inbox.inbox_id,
to="user@example.com",
subject="Hello from my AI agent",
text="Hi! I'm an AI agent with my own email address."
)

Получение писем и ответы

# List threads in the inbox
threads = client.inboxes.threads.list(inbox_id=inbox.inbox_id)
# Get the latest thread
thread = client.inboxes.threads.get(
inbox_id=inbox.inbox_id,
thread_id=threads.threads[0].thread_id
)
# Reply to the latest message
latest_message = thread.messages[-1]
client.inboxes.messages.reply(
inbox_id=inbox.inbox_id,
message_id=latest_message.message_id,
to=[latest_message.from_],
text="Thanks for your email! I'll look into this."
)

Интеграции для AI-конструкторов

Agent Inbox подключается к популярным платформам разработки агентов:

Чем Agent Inbox отличается от обычных почтовых API

В отличие от классических API под одностороннюю транзакционную рассылку, Agent Inbox заточен под двустороннюю коммуникацию агентов:

ВозможностьAgent InboxКлассические почтовые API
Ящики на агента✅ Тысячи через API❌ Общие домены отправки
Приём и разбор писем✅ Нативно, с тредами⚠️ Ограничено или доп. модули
Тредовые переписки✅ Полноценный API❌ Не поддерживается
Allowlist/blocklist✅ На уровне ящика❌ Нет
Мультитенантность (Pods)✅ Встроенная изоляция❌ Собирать самим
События WebSocket✅ Поток в реальном времени❌ Только вебхуки
Доступ IMAP/SMTP✅ Полный протокол❌ Только API
Оплата за использование✅ За письмо❌ Подписка за ящик

Дальше