Voice Agent

หน้านี้มีสองส่วน คือ การตั้งค่า agent ที่กำหนดพฤติกรรมของ agent และ รายการ ผู้ให้บริการเสียงกับเสียงที่ agent ใช้พูดได้

การทำงาน	Route
ดูการตั้งค่าทั้งหมด	GET /agents/configs
ดูการตั้งค่ารายการเดียว	GET /agents/configs/{documentId}
สร้าง	POST /agents/configs
แทนที่	PUT /agents/configs/{documentId}
ลบ	DELETE /agents/configs/{documentId}
ดูผู้ให้บริการ	GET /voice/providers
ดูเสียงของผู้ให้บริการ	GET /voice/providers/{provider}/voices

การตั้งค่า

การตั้งค่าเป็นเอกสารหนึ่งชุด studio จะเพิ่มฟิลด์เข้ามาเมื่อ agent มีความสามารถใหม่ ให้ส่งผ่านคีย์ที่ไม่รู้จักต่อไป แทนที่จะตัดทิ้ง

curl "$ME_BASE/agents/configs" \
  -H "API-Key: $ME_API_KEY" \
  -H "X-TenantID: $ME_TENANT"

รายการผู้ให้บริการและเสียง

ผู้ให้บริการที่ใช้ได้ขึ้นกับแต่ละ deployment ไม่ใช่ค่าคงที่ เพราะขึ้นกับ vendor key ที่ตั้งค่าไว้ในระบบนั้น ให้อ่านรายการตอนใช้งานจริง แทนการเขียนรายชื่อผู้ให้บริการไว้ในโค้ด

curl "$ME_BASE/voice/providers/elevenlabs/voices" \
  -H "API-Key: $ME_API_KEY" \
  -H "X-TenantID: $ME_TENANT"

{
  "data": [
    {
      "id": "voice_abc",
      "name": "Mali",
      "gender": "female",
      "language": "th-TH",
      "preview": true
    }
  ]
}

ฟิลด์	หมายเหตุ
id	ใช้เป็น voice id ของ agent
preview	เสียงนี้เล่นตัวอย่างบนระบบนี้ได้หรือไม่

ทำตามค่า preview

preview ถูกคำนวณใหม่ทุกครั้งที่เรียก เพราะเปลี่ยนตาม vendor key เมื่อเป็น false ให้ปิดปุ่มเล่นตัวอย่าง อย่าสลับไปเล่นเสียงอื่นแทน เพราะผู้ใช้จะได้ยินเสียงที่ agent ไม่ได้ใช้พูดจริง

Go SDK

configs, err := c.Agents.ListConfigs(ctx)
voices, err := c.Agents.ListVoices(ctx, "elevenlabs")