Как создать первый ящик?

Быстрый старт с первым ящиком Agent Inbox.

Ящик даёт агенту собственный адрес. Можно использовать домен по умолчанию @agentinbox.space или свой верифицированный домен.

Установите SDK

TypeScript
$npm install agentinbox

Создайте ящик

TypeScript
1import { AgentinboxClient } from "agentinbox";
2
3const client = new AgentinboxClient({ apiKey: "am_..." });
4
5// Create an inbox with a random address on agentinbox.space
6const inbox = await client.inboxes.create();
7console.log(`Inbox created: ${inbox.inboxId}`);

У ящика появится уникальный адрес (например randomname@agentinbox.space) — сразу можно отправлять и принимать почту.

Настройка ящика

Можно задать имя пользователя, домен и отображаемое имя:

TypeScript
1const inbox = await client.inboxes.create({
2 username: "support",
3 domain: "yourcompany.com",
4 displayName: "Support Agent",
5});
6
7// inbox.inboxId will be support@yourcompany.com
8console.log(`Inbox created: ${inbox.inboxId}`);

Свой домен должен быть верифицирован. См. Создание своих доменов. Без домена используется @agentinbox.space.

Идемпотентность через clientId

Если ящик создаётся программно (например при старте), используйте clientId, чтобы не плодить дубликаты — при совпадении вернётся существующий ящик:

TypeScript
1const inbox = await client.inboxes.create({
2 username: "my-agent",
3 clientId: "my-agent-inbox-v1",
4 displayName: "My Agent",
5});
6
7// Safe to call multiple times: same inbox returned every time

Первая отправка

TypeScript
1await client.inboxes.messages.send(inbox.inboxId, {
2 to: "recipient@example.com",
3 subject: "Hello from my agent!",
4 text: "This is a plain text version.",
5 html: "<p>This is an <strong>HTML</strong> version.</p>",
6});

Указывайте и text, и html — так письмо корректно отображается в клиентах и лучше доставляется.

Список ящиков

TypeScript
1const inboxes = await client.inboxes.list();
2console.log(`You have ${inboxes.count} inboxes.`);
3
4for (const inbox of inboxes.inboxes) {
5 console.log(` ${inbox.inboxId}`);
6}

Дальше