Skip to navigation
С чего начать

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

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

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

Установите SDK

TypeScript
npm install agentinbox

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Дальше