Метки
Метки
Организация и категоризация переписок агента в масштабе.
Что такое 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 можно передать сразу при отправке.
2. Добавить или снять метки у существующего Message
Метод update (PATCH): удобно менять состояние по ходу работы агента.
3. Фильтрация по Labels
Можно получать Threads, Messages и Drafts с фильтром по одной или нескольким меткам.
Скопировать в Cursor / Claude
Рекомендации
- Единообразие: договоритесь о стиле имён меток (
kebab-case,snake_caseи т.д.). - Префиксы: для состояний используйте префиксы вроде
status-pendingилиpriority-high. - Не перегружайте метками: много меток на одно сообщение возможно, но лучше держать набор осмысленным и компактным.
Скоро: авторазметка на ИИ
Мы делаем авторазметку на ИИ: агент задаст набор Labels и инструкции, а Agent Inbox будет сам проставлять метки входящим Messages по содержанию.
