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

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

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

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

MCP-сервер Agent Inbox

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

Настройка

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

1
{
2
  "mcpServers": {
3
    "Agent Inbox": {
4
      "command": "npx",
5
      "args": ["-y", "agentinbox-mcp"],
6
      "env": {
7
        "AGENTINBOX_API_KEY": "YOUR_API_KEY"
8
      }
9
    }
10
  }
11
}

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

1
{
2
  "mcpServers": {
3
    "Agent Inbox": {
4
      "command": "npx",
5
      "args": ["-y", "agentinbox-mcp", "--tools", "get_message,send_message,reply_to_message"],
6
      "env": {
7
        "AGENTINBOX_API_KEY": "YOUR_API_KEY"
8
      }
9
    }
10
  }
11
}

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

Документация 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"

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

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

1
from agentinbox import Agentinbox
2
3
client = Agentinbox(api_key="am_...")
4
inbox = client.inboxes.create(display_name="My AI Agent")
5
print(f"Agent email: {inbox.inbox_id}")
6
7
# Send an email
8
client.inboxes.messages.send(
9
    inbox.inbox_id,
10
    to="user@example.com",
11
    subject="Hello from my AI agent",
12
    text="Hi! I'm an AI agent with my own email address."
13
)

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

1
# List threads in the inbox
2
threads = client.inboxes.threads.list(inbox_id=inbox.inbox_id)
3
4
# Get the latest thread
5
thread = client.inboxes.threads.get(
6
    inbox_id=inbox.inbox_id,
7
    thread_id=threads.threads[0].thread_id
8
)
9
10
# Reply to the latest message
11
latest_message = thread.messages[-1]
12
client.inboxes.messages.reply(
13
    inbox_id=inbox.inbox_id,
14
    message_id=latest_message.message_id,
15
    to=[latest_message.from_],
16
    text="Thanks for your email! I'll look into this."
17
)

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

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

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

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

Дальше