Cấu hình hành vi kênh (channel) cho ElevenAgents

Tùy chỉnh phong cách phản hồi và giới hạn thời gian cho mỗi kênh văn bản.

Tổng quan

Bảng điều khiển Agent behavior quản lý tính cách mặc định và cách thức phản hồi trên từng kênh văn bản: Độ dài câu trả lời, việc sử dụng định dạng Markdown, và thời gian tối đa dành cho một lượt phản hồi. Một câu trả lời phù hợp cho khung chat trực tiếp (live widget) thường quá ngắn gọn đối với ticket Zendesk, trong khi câu trả lời trên Slack có thể sử dụng định dạng Markdown mà SMS không hỗ trợ.

Mỗi kênh đều bắt đầu với các thiết lập mặc định hợp lý, và bạn có thể thay đổi các cài đặt riêng cho từng kênh. Các cuộc hội thoại voice không bị ảnh hưởng: Chúng luôn sử dụng hành vi được tối ưu hóa cho cuộc gọi trực tiếp (phản hồi ngắn gọn, ở dạng plain text và giới hạn thời gian thực cho mỗi lượt).

Default personality (Tính cách mặc định)

Theo mặc định, một số quy tắc về phong cách phản hồi được thêm vào câu lệnh hệ thống (system prompt) của agent để đảm bảo hiệu quả ngay khi bắt đầu: Đưa ra phản hồi hữu ích, đầy đủ thông tin và lịch sự; đặt câu hỏi làm rõ khi cần thêm thông tin; giữ câu trả lời rõ ràng, súc tích; và tránh lặp lại thông tin giới thiệu bản thân trừ khi được hỏi.

Hãy tắt tính năng Default personality để loại bỏ các quy tắc này khi câu lệnh hệ thống của bạn đã quy định đầy đủ về giọng điệu của agent. Trong CLI và API, hãy đặt tham số conversation_config.agent.prompt.ignore_default_personality thành true.

Cài đặt kênh văn bản

Độ dài phản hồi (Verbosity)

Kiểm soát độ dài câu trả lời của agent.

• Auto (Tự động): Để mô hình tự chọn độ dài phản hồi.
• Concise (Ngắn gọn): Trả lời trong một hoặc hai câu.
• Thorough (Chi tiết): Trả lời với nhiều đoạn văn chi tiết.

Định dạng đầu ra (Output format)

Kiểm soát việc liệu câu trả lời có được sử dụng định dạng Markdown hay không.

• Plain text: Gửi phản hồi không kèm định dạng.
• Markdown: Gửi phản hồi có định dạng Markdown. Chỉ sử dụng tùy chọn này trên các kênh hỗ trợ hiển thị Markdown, chẳng hạn như Slack.

Thời gian phản hồi (Response time)

Giới hạn thời gian thực tế mà agent có thể sử dụng cho một lượt phản hồi, bao gồm quá trình suy luận, gọi công cụ và thử lại. Thời gian cho phép dài hơn giúp agent hoàn thành các chuỗi tác vụ công cụ phức tạp nhưng sẽ làm tăng độ trễ phản hồi. Trong CLI và API, cài đặt này có tên là interaction_budget.

• Thời gian thực (Realtime): Kết thúc lượt phản hồi nhanh chóng để duy trì độ trễ thấp cho các cuộc hội thoại trực tiếp.
• 5 phút: Cho phép vài phút để suy luận và sử dụng công cụ trong các kênh văn bản không đồng bộ.
• 10 phút: Cho phép thời gian xử lý dài hơn đối với các chuỗi công cụ phức tạp.
• 1 giờ: Cho phép tác vụ chạy ngầm trong thời gian dài đối với những tác vụ tốn nhiều thời gian nhất.

Các thiết lập kênh mặc định

Mỗi kênh đều đi kèm với các thiết lập mặc định được tinh chỉnh riêng cho kênh đó. Ví dụ, Slack mặc định sử dụng phản hồi chi tiết, định dạng Markdown với hạn mức thời gian xử lý dài hơn, trong khi web widget mặc định sử dụng phản hồi dạng plain text với hạn mức thời gian thực. Dashboard hiển thị các thiết lập mặc định đang được áp dụng cho từng kênh; kênh sẽ sử dụng các thiết lập mặc định này cho bất kỳ tùy chọn nào không được cấu hình riêng.

Cấu hình

Cấu hình cơ chế hoạt động của kênh thông qua trường conversation_config.agent.text_behavior_overrides; đây là một cấu trúc ánh xạ (map) từ kênh sang các thiết lập mà bạn muốn ghi đè (thay đổi so với mặc định).

Cập nhật qua dashboard

Mở agent của bạn trong dashboard, chọn tab Agent và mở Agent behavior. Mở rộng một kênh trong Text channels và điều chỉnh độ chi tiết, định dạng đầu ra hoặc thời gian phản hồi. Lưu các thay đổi của bạn.

Cập nhật qua giao diện dòng lệnh (CLI)

1. Tải cấu hình agent về

elevenlabs agents pull --agent agent_7101k5zvyjhmfg983brhmhkd98n6

2. Chỉnh sửa file cấu hình của agent trong thư mục agent_configs/

Thiết lập conversation_config.agent.text_behavior_overrides:

{
  "conversation_config": {
    "agent": {
      "text_behavior_overrides": {
        "slack_integration": {
          "verbosity": "concise"
        },
        "widget": {
          "interaction_budget": "5_minutes"
        }
      }
    }
  }
}

3. Đẩy các thay đổi của bạn lên

elevenlabs agents push --agent agent_7101k5zvyjhmfg983brhmhkd98n6

Cập nhật qua API

Python

from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "agent": {
            "text_behavior_overrides": {
                "slack_integration": {"verbosity": "concise"},
                "widget": {"interaction_budget": "5_minutes"},
            },
        },
    },
)

TypeScript

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

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    agent: {
      textBehaviorOverrides: {
        slack_integration: { verbosity: "concise" },
        widget: { interactionBudget: "5_minutes" },
      },
    },
  },
});