Что такое метки?
Метки — это простые теговые метки на основе строк, которые вы можете прикреплять к своим сообщениям и цепям. Они являются основным механизмом для организации, категоризации и управления состоянием ваших бесед, будь то автоматическое распределение цепей по определенным категориям для вашей исходящей кампании, сегментация горячих лидов для вашего аутрича или категоризация входящих по маловартостным, среднестоимостным, высокостоимостным клиентам.
Сообщение может иметь несколько меток, позволяя вам создавать гибкую и мощную систему для управления сложными рабочими процессами.
Варианты использования меток
Стратегически применяя метки, вы можете создавать сложные системы агентов. Вот несколько распространенных вариантов использования:
Управление состоянием
Используйте
метки для отслеживания состояния беседы. Например, агент может применить needs-human-review, когда он не уверен, как ответить, или надзиратель может применить approved-to-send к черновику.Отслеживание кампаний
При запуске исходящих кампаний пометьте каждое
сообщение уникальной меткой кампании, такой как q4-2024-outreach или mercor-campaign, и добавьте второй тег как warm-lead. Это позволяет вам легко фильтровать и анализировать производительность этой конкретной кампании позже.Основные возможности
Вот как вы можете программно работать сметками.
1. Добавление меток при отправке сообщения
Вы можете прикрепить массив меток непосредственно при отправке сообщения.
sent_message = client.inboxes.messages.send(
inbox_id="outbound@agentinbox.ru",
to=["test@example.com"],
subject="Following up on our conversation",
text="Here is the information you requested.",
labels=["follow-up", "q4-campaign"]
)
2. Добавление или удаление меток в существующем сообщении
Вы можете изменить метки на сообщении, которое уже было отправлено, используя метод update (PATCH). Это идеально подходит для изменения состояния беседы по мере работы вашего агента.
# Let's add a 'resolved' label to a message
client.messages.update(
inbox_id='outbound@domain.com',
message_id='msg_id_123',
add_labels=["resolved"],
remove_labels=['unresolved']
)
3. Фильтрация по меткам
Это то место, где метки становятся действительно мощными. Вы можете перечислять цепи, сообщения и черновики, фильтруя по одной или нескольким меткам, позволяя вам создавать высоко целевые запросы.
# Find all threads from a specific campaign that need a 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.")
Лучшие практики
* Будьте последовательны: Установите четкое и последовательное соглашение об именовании ваших меток (например,kebab-case, snake_case).
* Используйте префиксы: Для управления состоянием рассмотрите использование префиксов, таких как status-pending или priority-high, для создания организованной системы.
* Не переусложняйте: Хотя вы можете добавить много меток, стремитесь к краткому и значительному набору, чтобы ваша система была управляемой.
Мы активно разрабатываем функцию автоматической маркировки на основе ИИ. Вскоре ваши агенты смогут предоставить набор
меток и инструкции, и AgentInbox будет автоматически применять правильные метки к входящим сообщениям на основе их содержимого.