Skip to main content

​
Организация беседы в ваших входящих ящиках.

​
Что такое цепь?

Цепь — это ресурс API, который представляет одну беседу. Она действует как контейнер, группирующий серию связанных сообщений вместе в хронологическом порядке, точно так же, как цепь беседы в традиционном почтовом клиенте. Цепи создаются автоматически. Когда ваш агент отправляет сообщение, которое не является ответом на предыдущее, инициируется новая цепь. Любые последующие ответы автоматически добавляются в эту же цепь, позволяя вашему агенту легко сохранять контекст беседы с течением времени.

​
Запрос цепей

Хотя цепи создаются неявно, вы можете получить их двумя мощными способами: ограниченные одним входящим ящиком или по всей вашей организации.

​
Перечисление цепей в входящем ящике

Это стандартный способ получить все беседы, связанные с одним агентом или входящим ящиком. # You'll need an inbox ID to list threads from. inbox_id = "inbound-agent@agentinbox.ru" # This retrieves all threads within the specified Inbox inbox_threads = client.inboxes.threads.list(inbox_id=inbox_id)

​
Перечисление цепей по всей организации

Это одна из самых мощных возможностей AgentInbox. Опустив inbox_id, вы можете получить список цепей от каждого входящего ящика в вашей организации. Эта возможность запроса на уровне организации необходима для создания:
  • Агентов-надзирателей: Агента, который контролирует беседы из флота других агентов.
  • Аналитических панелей: Создание решения, где вам нужна видимость по всем входящим ящикам в организации
  • Продвинутых рабочих процессов: Системы, которые могут направлять или эскалировать беседы между различными агентами с разными разрешениями. # By not providing an inbox_id, we get all threads in the organization all_threads = client.threads.list() print(f"Found {all_threads.count} threads across the entire organization.")
Мы активно разрабатываем семантический поиск для конечной точки перечисления цепей на уровне организации. Вскоре вы сможете найти цепи на основе смысла и концепций в сообщениях, а не только по ключевым словам.

​
Получение одной цепи

Вы также можете получить одну цепь по ее ID. Это вернет объект цепь, который обычно содержит список всех связанных с ней сообщений и их ID. Распространенный рабочий процесс — перечисление сообщений в цепи и вызов метода messages.reply на последнем. thread_id = "thread_456def" # This retrieves a single thread and its messages thread = client.threads.get( thread_id="thread_id" ) print(f"Retrieved thread {thread.thread_id} with {len(thread.messages)} messages.")