Công cụ End call trong ElevenAgents: Cho phép agent tự động ngắt cuộc gọi với người dùng

Công cụ End Call được thêm mặc định vào các agent tạo trên dashboard ElevenLabs. Đối với các agent được tạo thông qua API hoặc SDK, nếu muốn kích hoạt công cụ này, bạn cần thêm nó theo cách thủ công dưới dạng công cụ hệ thống (system tool) trong cấu hình agent của mình. Xem phần "Triển khai qua API" bên dưới để biết thêm chi tiết.

Tổng quan

Công cụ End Call cho phép agent đàm thoại của bạn chấm dứt cuộc gọi với người dùng. Đây là một công cụ hệ thống mang lại sự linh hoạt trong việc quyết định cách thức và thời điểm kết thúc cuộc gọi.

Chức năng

Hoạt động mặc định: Công cụ có thể vận hành mà không cần bất kỳ câu lệnh (prompt) nào do người dùng định nghĩa; cuộc gọi sẽ tự động kết thúc khi cuộc hội thoại đi đến hồi kết một cách tự nhiên.

Prompt tùy chỉnh: Người dùng có thể thiết lập các điều kiện cụ thể để kết thúc cuộc gọi. Ví dụ:

• Kết thúc cuộc gọi nếu người dùng nói "tạm biệt".

• Kết thúc cuộc gọi khi một tác vụ cụ thể đã hoàn tất.

Mục đích: Tự động chấm dứt các cuộc hội thoại khi các điều kiện phù hợp được đáp ứng.

Điều kiện kích hoạt: Mô hình ngôn ngữ lớn (LLM) nên gọi công cụ này khi:

• Tác vụ chính đã hoàn tất và người dùng đã hài lòng.

• Cuộc hội thoại đi đến hồi kết một cách tự nhiên với sự đồng thuận từ cả hai phía.

• Người dùng bày tỏ rõ ràng mong muốn kết thúc cuộc hội thoại.

Các tham số:

• reason (chuỗi, bắt buộc): Lý do kết thúc cuộc gọi.

• message (chuỗi, tùy chọn): Lời chào tạm biệt gửi đến người dùng trước khi kết thúc cuộc gọi.

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

{
  "type": "function",
  "function": {
    "name": "end_call",
    "arguments": "{\"reason\": \"Task completed successfully\", \"message\": \"Thank you for using our service. Have a great day!\"}"
  }
}

Triển khai: Định cấu hình công cụ này dưới dạng công cụ hệ thống (system tool) trong các thiết lập agent của bạn. Mô hình ngôn ngữ lớn (LLM) sẽ nhận được các hướng dẫn chi tiết về thời điểm cần gọi hàm này.

Triển khai qua API

Khi tạo một agent thông qua API, bạn có thể thêm công cụ End Call vào cấu hình agent của mình. Công cụ này cầ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": {
                    "end_call": {
                        "type": "system",
                        "name": "end_call",
                        # Optional: customize when the tool should be triggered
                        "description": "",
                        "params": {"system_tool_type": "end_call"},
                    }
                }
            },
        ),
    ),
)

JavaScript

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

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

await elevenlabs.conversationalAi.agents.create({
  conversationConfig: {
    agent: {
      prompt: {
        builtInTools: {
          endCall: {
            type: "system",
            name: "end_call",
            description: "", // Optional: Customize when the tool should be triggered
            params: { systemToolType: "end_call" },
          },
        },
      },
    },
  },
});

Bash

curl -X POST https://api.elevenlabs.io/v1/convai/agents/create \
     -H "xi-api-key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
  "conversation_config": {
    "agent": {
      "prompt": {
        "built_in_tools": {
          "end_call": {
            "type": "system",
            "name": "end_call",
            "description": "",
            "params": { "system_tool_type": "end_call" }
          }
        }
      }
    }
  }
}'

Để trống phần mô tả nếu muốn sử dụng prompt kết thúc cuộc gọi mặc định.

Các prompt ví dụ

Ví dụ 1: Kết thúc cuộc gọi cơ bản

End the call when the user says goodbye, thank you, or indicates they have no more questions.

Kết thúc cuộc gọi khi người dùng nói lời tạm biệt, cảm ơn hoặc cho biết họ không còn câu hỏi nào khác.

Ví dụ 2: Kết thúc cuộc gọi với lời nhắc tùy chỉnh

End the call when the user says goodbye, thank you, or indicates they have no more questions. You can only end the call after all their questions have been answered. Please end the call only after confirming that the user doesn't need any additional assistance.

Kết thúc cuộc gọi khi người dùng nói lời tạm biệt, cảm ơn hoặc cho biết họ không còn câu hỏi nào