Skip to navigation
Сценарии для агентов

Как сделать human-in-the-loop?

Контроль человека над почтой агента.

Несколько механик, чтобы человек оставался в контуре при отправке писем агентом.

1. Копия человеку (CC / BCC)

Самый простой вариант — копировать руководителя на каждое исходящее.

Python
client.inboxes.messages.send(
    inbox_id="agent@yourdomain.com",
    to=["customer@example.com"],
    cc=["manager@yourcompany.com"],
    subject="Re: Your request",
    text="I've processed your refund...",
    html="<p>I've processed your refund...</p>"
)

bcc — если получатель не должен видеть копию.

2. Черновики до отправки

Агент создаёт черновик, человек утверждает — для договоров, юридических и финансовых писем.

Python
draft = client.inboxes.drafts.create(
    inbox_id="agent@yourdomain.com",
    to=["important-client@example.com"],
    subject="Contract proposal",
    text="Here is our proposal...",
    html="<p>Here is our proposal...</p>"
)
print(f"Draft created: {draft.draft_id}")
sent_message = client.inboxes.drafts.send(
    inbox_id="agent@yourdomain.com",
    draft_id=draft.draft_id
)

Все черновики организации:

Python
all_drafts = client.drafts.list()
print(f"{all_drafts.count} drafts pending review")

См. Черновики.

3. Метки для эскалации

Python
client.inboxes.messages.update(
    inbox_id="agent@yourdomain.com",
    message_id=msg.message_id,
    add_labels=["needs-human-review", "escalation"]
)

Периодический опрос:

Python
flagged = client.inboxes.messages.list(
    inbox_id="agent@yourdomain.com",
    labels=["needs-human-review"]
)
for msg in flagged.messages:
    notify_human(msg)

4. Allowlist как жёсткая граница

Send allowlist — письма только на явно разрешённые адреса/домены; иначе API отклонит запрос.

Python
client.lists.create("send", "allow", entry="trusted-customer.com")
client.lists.create("send", "allow", entry="partner-corp.com")

Практика

  • В начале — CC + черновики, пока нет доверия к агенту
  • Рутину можно автоматизировать; важное — через черновики
  • Всегда задавайте эскалацию, когда агент не уверен
  • Единые соглашения по меткам для дашбордов и алертов
  • Комбинируйте: allowlist для известных получателей, черновики для новых, CC на первое время