Передача завдань між агентами в LangChain: створення робочого процесу служби підтримки IT з одним агентом.
Один агент LangChain, який змінює свій запит та інструменти на кожному кроці: поетапна служба підтримки IT із перевіркою справжньої ідентичності, передачею даних через проміжне програмне забезпечення та вихідом за межі обсягу роботи.
Уявіть собі, що ви телефонуєте до служби підтримки ІТ після того, як не можете увійти до свого облікового запису. Людина на лінії не ставить однакові запитання на кожному етапі, а те, що вона може зробити, залежить від того, на якій стадії знаходиться розмова. Спочатку вона підтверджує вашу особу, зазвичай за допомогою ідентифікаційного номера співробітника або імені керівника, і не буде торкатися проблеми з обліковим записом, поки це не буде вирішено. Далі вона з’ясовує, у чому проблема: заблокований обліковий запис, забутий пароль чи відсутній пристрій автентифікації. Лише після цього вона починає діяти – відновлює доступ до облікового запису, надсилає посилання для скидання пароля чи передає дзвінок до команди з безпеки. Для абонента це здається однією розмовою, хоча її обсяг змінюється з розвитком діалогу.
Передачі даних надають штучному інтелекту однакову структуру. Агент змінює те, що йому дозволено робити, відповідно до поточної стадії взаємодії. Спочатку він збирає лише ідентифікаційні дані. Коли це зроблено, він запитує про справжню проблему, а як тільки проблема стає зрозумілою, він починає діяти.
Два способи її створення
- Тип 1 — підхід з проміжним програмним забезпеченням, передбачає використання одного агента, чиї повноваження змінюються у міру розвитку розмови. Уявіть собі того самого працівника служби підтримки, який працює за чек-листом.
- Тип 2 — підхід з кількома агентами, передбачає використання кількох агентів, які передають розмову один одному, подібно до передачі справи в інший відділ, коли перша особа не може допомогти.
Наведена нижче версія відповідає типу 1, який часто називають типом з одним агентом, оскільки код містить саме одного агента. Цей агент перевіряє ідентичність користувача, потім діагностує проблему та її вирішує. Ні в який момент не з’являється новий агент. Змінюються лише його інструкції та набір інструментів на початку кожного етапу. Тип 2 відрізняється тим, що створює окремих агентів та передає їм обмін інформацією між собою.
Проект
Метою є створення агента служби підтримки ІТ, і в коді дотримуються три правила:
- Проблеми з обліковими записами не обговорюються, поки ідентичність користувача не буде підтверджена за допомогою реальних даних.
- Жодних дій не вживається, поки проблема не належить до однієї з трьох підтримуваних категорій.
- Якщо проблема не підходить до жодної з категорій, агент просто це зазначає, замість того щоб здогадуватися.
Приклад роботи
Користувач звертається до служби підтримки після того, як його заблокували у корпоративному обліковому записі. Співробітник просить надати ідентифікатор працівника та ім’я керівника. Перша спроба не знаходить відповідної запису про працівника, тому співробітник просить ще раз, а друга спроба підтверджує дані. Потім співробітник запитує про проблему. Спочатку користувач згадує про особистий інтернет-банкінговий рахунок, який співробітник правильно віднімає до сфери, що не підпадає під підтримку. Після того, як користувач уточнює, що проблема полягає у корпоративному ІТ-порталі, співробітник класифікує її як заблокований обліковий запис, відновлює доступ та завершує розмову після підтвердження вирішення запиту.
Пошаговий аналіз коду
1. Схема стану
class HelpdeskState(AgentState):
current_step: NotRequired[HelpdeskStep]
identity_verified: NotRequired[bool]
verification_attempts: NotRequired[int]
issue_type: NotRequired[Literal["locked_account", "forgotten_password", "lost_mfa_device"]]
Поле current_step визначає, який елемент STEP_CONFIG впливає на наступну відповідь, що знову розглядається у розділі 4. Ще три поля (identity_verified, verification_attempts та issue_type) зберігають інформацію, зібрану під час розмови до цього моменту. Їх додають до запитів за допомогою .format(), тож у запиті на вирішення проблеми може бути рядок на кшталт EMPLOYEE STATUS: identity_verified = {identity_verified}.
2. Основні дані для перевірки
EMPLOYEE_DIRECTORY = {
"EMP-4471": {"name": "Amit Rao", "manager": "Priya Nair", "department": "Finance"},
"EMP-1029": {"name": "Sara Khan", "manager": "David Chen", "department": "Engineering"},
"EMP-3305": {"name": "Neha Verma", "manager": "Priya Nair", "department": "Finance"},
}
MAX_VERIFICATION_ATTEMPTS = 3
def normalize_employee_id(raw_id: str) -> str:
digits = "".join(ch for ch in raw_id if ch.isdigit())
return f"EMP-{digits}" if digits else raw_id.strip().upper()
Модель ніколи не вирішує, чи є ідентифікатор співробітника дійсним. Функція verify_identity порівнює цей ідентифікатор із базою даних EMPLOYEE_DIRECTORY, тому відповідь отримується шляхом пошуку, а не на основі думки моделі. Нормалізатор також допомагає впоратися з різними способами введення одного й того самого ідентифікатора: 4471, emp4471 та EMP-4471 усі перетворюються на один формат перед пошуком, що запобігає відхиленню дійсних ідентифікаторів через різницю у форматуванні.
3. Інструменти
Інструменти бувають двох видів. Інструменти переходу повертають об’єкт Command. Він записує нові значення у стан робочого процесу та переводить current_step на наступну стадію.
@tool
def verify_identity(
employee_id: str,
manager_name: str,
runtime: ToolRuntime[None, HelpdeskState],
) -> Command:
attempts = (runtime.state.get("verification_attempts") or 0) + 1
normalized_id = normalize_employee_id(employee_id)
record = EMPLOYEE_DIRECTORY.get(normalized_id)
verified = bool(record and manager_name.strip().lower() == record["manager"].lower())
if verified:
content = f"Identity verified for {normalized_id} ({record['name']})."
elif attempts >= MAX_VERIFICATION_ATTEMPTS:
content = f"Verification failed {attempts} times. Session locked — visit IT in person."
elif record is None:
content = f"No employee found with ID '{employee_id}'. Please retry."
else:
content = "The manager name doesn't match our records. Please retry."
return Command(
update={
"messages": [ToolMessage(content=content, tool_call_id=runtime.tool_call_id)],
"identity_verified": verified,
"verification_attempts": attempts,
"current_step": "issue_diagnosis" if verified else "identity_verification",
}
)
Перевірка має чотири можливі результати. Вона успішна лише тоді, коли ідентифікатор працівника та ім’я керівника збігаються з даними в записі. Інші три результати – це досягнення максимальної кількості спроб, використання ідентифікатора, якого немає, або використання існуючого ідентифікатора з неправильним ім’ям керівника. Кожен випадок призводить до різного повідомлення. Перевірений користувач переходить до кроку issue_diagnosis, а всі інші випадки залишаються на кроці identity_verification; тому нічого не продовжується, доки особа не буде підтверджена.
Інструменти терміналу повертають звичайний рядок та не змінюють значення current_step, оскільки робочий процес досяг своєї останньої стадії.
@tool
def flag_out_of_scope(reason: str) -> str:
return (
f"This request appears to be about a personal account, not your "
f"company IT account ({reason}). This helpdesk can't assist with "
f"that — please contact the relevant provider directly."
)
flag_out_of_scope має таке ж значення, як і класифікатор. Без нього робочий процес намагатиметься віднести кожен запит до одного з підтримуваних типів проблем, навіть тих, що не пов’язані, тож проблема з особистим банкінгом може бути неправильно позначена як проблема з технічною підтримкою. Цей інструмент дає агенту зручний спосіб розпізнавати запити, які виходять за межі сфери дії робочого процесу.
4. Запити та налаштування кроків
Кожен етап має власний запит та власний список інструментів, які зберігаються в одному словнику та обираються за поточним значенням current_step.
STEP_CONFIG = {
"identity_verification": {"prompt": IDENTITY_VERIFICATION_PROMPT, "tools": [verify_identity], "requires": []},
"issue_diagnosis": {"prompt": ISSUE_DIAGNOSIS_PROMPT, "tools": [record_issue_type, flag_out_of_scope], "requires": ["identity_verified"]},
"resolution": {"prompt": RESOLUTION_PROMPT, "tools": [unlock_account, send_password_reset_link, escalate_mfa_recovery, go_back_to_verification], "requires": ["identity_verified", "issue_type"]},
}
Поле requires виконує функцію захисту для мідлверу, який перевіряє, чи дотримуються необхідні умови, перш ніж застосувати налаштування кроку.
5. Мідлвер
@wrap_model_call
def apply_step_config(
request: ModelRequest,
handler: Callable[[ModelRequest], ModelResponse],
) -> ModelResponse:
current_step = request.state.get("current_step", "identity_verification")
step_config = STEP_CONFIG[current_step]
for key in step_config["requires"]:
if request.state.get(key) is None:
raise ValueError(f"'{key}' must be set before reaching '{current_step}'")
system_prompt = step_config["prompt"].format(**request.state)
request = request.override(system_prompt=system_prompt, tools=step_config["tools"])
return handler(request)
Назва походить від місця, де виконується цей код: між поточним станом робочого процесу та викликом моделі. Перш ніж модель відповість, мідлвейр читає стан, замінює запит та інструменти на відповідні для поточного кроку, а потім передає керування далі. Він виконується перед кожним викликом моделі. Він читає current_step, завантажує відповідну конфігурацію, перевіряє, чи виконані необхідні умови, форматує запит з використанням значень поточного стану та призначає відповідні інструменти. Саме так змінюється поведінка агента у міру руху робочого процесу.
6. Створення агента
agent = create_agent(
model,
tools=all_tools,
state_schema=HelpdeskState,
middleware=[apply_step_config],
checkpointer=InMemorySaver(),
)
Чекпоїнтер є необхідним, оскільки він зберігає стан робочого процесу між повідомленнями. Без нього current_step скидається після кожного виклику, і агент щоразу починає з першого кроку, так і не просуваючись далі.
Вибір рішень, які запобігають помилкам
Існує кілька деталей, які допомагають уникнути поширених проблем у такому типі робочих процесів.
- Перевірка ґрунтується на реальному записі. Якби
verify_identityставив запитання моделі щодо того, чи виглядають ідентифікатор та ім’я керівника правильно, будь-яка правдоподібна відповідь пройшла б перевірку. Пошук уEMPLOYEE_DIRECTORYусуває необхідність здогадок. - Ідентифікатори нормалізуються перед порівнянням. Вимога до точного формату, наприклад EMP-4471, призводить до відхилення таких дійсних значень, як 4471 або emp4471, лише через спосіб їх введення. Нормалізатор спочатку перетворює поширені формати на один стандартний варіант.
record_issue_type приймає лише три категорії. Без flag_out_of_scope несуміжні запити, такі як питання про банківські послуги, будуть примушено віднесені до найближчої категорії.user_input in {"quit", "exit"} працює лише тоді, коли весь текст точно є одним із цих слів. Регулярні вирази, що враховують межі слів, фіксують їх у будь-якому місці речення, включаючи вирази на кшталт „quit and exit“.У кожному випадку найпростіша реалізація здається прийнятною, але зазнає невдачі при реальному вхідному даних.
Коротко про шаблон
Передача обов’язків між окремими агентами потребує лише трьох елементів. Поле current_step зберігає поточну стадію, інструменти змінюють його, а проміжне програмне забезпечення звертається до нього перед кожним викликом моделі. Разом вони керують процесом розвитку робочого потоку. Правильна робота все одно залежить від деталей: перевірки за реальними даними, нормалізації ідентифікаторів, надання варіантів дій поза межами сфери дії та правильного підбору слів для завершення. Машина станів контролює порядок виконання кроків у робочому потоці, а логіка перевірки гарантує належну роботу кожного кроку.
Пов’язана література
- Практичні нотатки: створення агента для глибоких досліджень за допомогою LangChain Deep Agents and — детальний посібник з практичних нотаток щодо створення такого агента, який включає контракти, перевірки та готові фрагменти коду для команд, що використовують цю модель.