AI Agent Human Handoff: When to Transfer to a Real Person

AI Agent Human Handoff: When to Transfer to a Real Person

💡 What You Will Learn

AI Agent Human Handoff: When to Transfer to a Real Person

class HandoffDetector:
    """"""
    def __init__(self):
        self.handoff_keywords = [
            "", "", "", "", "",
            "", "", "", ""
        ]

    def should_handoff(self, user_input: str, confidence: float,
                       conversation_history: list) -> tuple:
        """ (, )"""
        # 1
        if any(kw in user_input for kw in self.handoff_keywords):
            return True, ""

        # 2AI
        if confidence < 0.4:
            return True, f"AI({confidence:.2f})"

        # 35Conversation
        if len(conversation_history) >= 5:
            recent = conversation_history[-3:]
            if not any(self._has_progress(r) for r in recent):
                return True, ""

        return False, ""

    def _has_progress(self, turn: dict) -> bool:
        return turn.get('resolved', False) or turn.get('action_taken', False)

SUMMARY_PROMPT = """


{name}
ID{user_id}
{category}

Conversation
2-3


AI




Conversation
{conversation}
"""

def generate_handoff_summary(conversation: list, user_info: dict) -> str:
    conv_text = "\n".join([
        f"{'' if t['role']=='user' else 'AI'}: {t['content']}"
        for t in conversation
    ])
    prompt = SUMMARY_PROMPT.format(
        name=user_info.get('name', ''),
        user_id=user_info.get('id', ''),
        category=user_info.get('category', ''),
        conversation=conv_text
    )
    return llm.invoke(prompt)

|:----|:-----------|:------------| || 52% | 83% | || 3.2/5 | 4.6/5 |