Công cụ Voicemail detection trong ElevenAgents

Tổng quan

Công cụ Voicemail Detection cho phép agent ElevenLabs của bạn tự động nhận diện khi một cuộc gọi được trả lời bởi hệ thống hộp thư thoại thay vì một người thật. Công cụ hệ thống này giúp các agent xử lý những tình huống gặp hộp thư thoại một cách linh hoạt: Để lại một tin nhắn đã được thiết lập sẵn hoặc kết thúc cuộc gọi ngay lập tức.

Chức năng

• Phát hiện tự động: Mô hình ngôn ngữ lớn (LLM) phân tích các kiểu hội thoại để nhận diện hệ thống hộp thư thoại dựa trên những lời chào và thông báo tự động.

• Phản hồi tùy chỉnh: Bạn có thể chọn để lại một tin nhắn hộp thư thoại tùy chỉnh hoặc kết thúc cuộc gọi ngay lập tức khi phát hiện hộp thư thoại.

• Kết thúc cuộc gọi: Sau khi phát hiện và thực hiện tùy chọn để lại tin nhắn (nếu có), cuộc gọi sẽ tự động được kết thúc.

• Theo dõi trạng thái: Các sự kiện phát hiện hộp thư thoại được ghi lại và có thể xem trong lịch sử hội thoại cũng như kết quả của các cuộc gọi hàng loạt.

Tham số:

• reason (chuỗi, bắt buộc): Lý do phát hiện hộp thư thoại (ví dụ: “phát hiện lời chào tự động”, “không có phản hồi từ con người”)

Định dạng gọi hàm:

{
  "type": "function",
  "function": {
    "name": "voicemail_detection",
    "arguments": "{\"reason\": \"Automated greeting detected with request to leave message\"}"
  }
}

Tùy chọn cấu hình

Công cụ Voicemail Detection có thể được cấu hình với các tùy chọn sau:

• Voicemail Message: Bạn có thể cấu hình một tin nhắn tùy chỉnh tùy chọn để phát khi phát hiện thư thoại. Tin nhắn này hỗ trợ các biến động, cho phép bạn cá nhân hóa tin nhắn thư thoại với những giá trị runtime như {{user_name}} hoặc {{appointment_time}}

Triển khai API

Khi tạo một agent thông qua API, bạn có thể thêm công cụ Voicemail Detection vào cấu hình agent của mình. Nó nên được định nghĩa là một công cụ hệ thống:

Python

from elevenlabs import AgentConfig, ConversationalConfig, ElevenLabs

elevenlabs = ElevenLabs(api_key="YOUR_API_KEY")

response = elevenlabs.conversational_ai.agents.create(
    conversation_config=ConversationalConfig(
        agent=AgentConfig(
            prompt={
                "built_in_tools": {
                    "voicemail_detection": {
                        "type": "system",
                        "name": "voicemail_detection",
                        # Optional: customize when the tool should be triggered
                        "description": "",
                        "params": {
                            "system_tool_type": "voicemail_detection",
                            # Optional: message left when voicemail is detected
                            "voicemail_message": "Sorry I missed you. I'll call back later.",
                        },
                    }
                }
            },
        ),
    ),

JavaScript

import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient({
  apiKey: "YOUR_API_KEY",
});

await elevenlabs.conversationalAi.agents.create({
  conversationConfig: {
    agent: {
      prompt: {
        builtInTools: {
          voicemailDetection: {
            type: "system",
            name: "voicemail_detection",
            description: "", // Optional: Customize when the tool should be triggered
            params: {
              systemToolType: "voicemail_detection",
              // Optional: message left when voicemail is detected
              voicemailMessage: "Sorry I missed you. I'll call back later.",
            },
          },
        },
      },
    },
  },
});