Метки | Agent Inbox | Документация

Что такое `Labels`?

Labels — простые строковые теги для Messages и Threads. Это основной способ упорядочивать переписки и вести состояние: автоматически раскладывать треды по кампаниям, сегментировать лиды в аутриче или классифицировать входящие по уровню запроса.

У Message может быть несколько Labels — гибкая модель для сложных процессов.

Сценарии для `Labels`

Управление состоянием

Отслеживайте состояние диалога: агент ставит needs-human-review, если не уверен; супервайзер — approved-to-send на Draft.

Кампании

В аутриче помечайте каждое Message уникальной меткой кампании вроде q4-2024-outreach или mercor-campaign и второй меткой вроде warm-lead. Потом легко фильтровать и анализировать результаты.

Автоматическая сортировка

Входящий агент может ставить billing-question, feature-request, bug-report — дальше подключаются специализированные агенты или люди.

Прочитано / непрочитано

Отмечайте обработанные Messages: после обработки добавьте read, снимите unread. Фильтр labels=["unread"] даёт только новые письма — агент не крутит одно и то же. Примеры — в Пометка сообщений как прочитанных.

Основные операции

1. Метки при отправке `Message`

Массив Labels можно передать сразу при отправке.

sent_message = client.inboxes.messages.send(
    inbox_id="outbound@agentinbox.space",
    to=["test@example.com"],
    subject="Following up on our conversation",
    text="Here is the information you requested.",
    labels=["follow-up", "q4-campaign"]
)

2. Добавить или снять метки у существующего `Message`

Метод update (PATCH): удобно менять состояние по ходу работы агента.

# Добавим метку 'resolved'
client.messages.update(
inbox_id='outbound@domain.com',
message_id='<abc123@agentinbox.space>',
add_labels=["resolved"],
remove_labels=['unresolved']
)

3. Фильтрация по `Labels`

Можно получать Threads, Messages и Drafts с фильтром по одной или нескольким меткам.

# Треды кампании, которым нужен follow-up
filtered_threads = client.inboxes.threads.list(
    inbox_id = 'outbound-agent@domain.com',
    labels=[
        "q4-campaign",
        "follow_up"
    ]
)
print(f"Found {filtered_threads.count} threads that need a follow-up.")

Скопировать в Cursor / Claude

"""
Agent Inbox Labels — copy into Cursor/Claude.
Labels are string tags on Messages and Threads for state, campaigns, triage.
- Send: messages.send(..., labels=["campaign", "follow-up"])
- Update: inboxes.messages.update(inbox_id, message_id, add_labels=[...], remove_labels=[...])
- Filter: messages.list(inbox_id, labels=[...]), threads.list(inbox_id, labels=[...]), drafts.list(inbox_id, labels=[...])
Use kebab-case or snake_case consistently.
"""
from agentinbox import Agentinbox
client = Agentinbox(api_key="YOUR_API_KEY")
# Send with labels
client.inboxes.messages.send("out@agentinbox.space", to="user@example.com", subject="Hi", text="Body", labels=["q4-campaign"])
# Update labels
client.inboxes.messages.update("out@agentinbox.space", "<abc123@agentinbox.space>", add_labels=["resolved"], remove_labels=["pending"])
# Filter by labels
threads = client.inboxes.threads.list("out@agentinbox.space", labels=["q4-campaign", "follow-up"])

Что такое Labels?

Сценарии для Labels