แปลเนื้อหาอะแดปทีฟการ์ดให้เป็นภาษาท้องถิ่น

โดยใช้ อะแดปทีฟการ์ด คุณสามารถนําเสนอข้อมูลที่สมบูรณ์ มีโครงสร้างแก่ผู้ใช้ของตัวแทน Copilot Studio สําหรับตัวแทนที่มีหลายภาษา ตรวจสอบให้แน่ใจว่าได้แปลทั้งเนื้อหาหัวข้อและข้อความอะแดปทีฟการ์ดของคุณเป็นภาษาท้องถิ่นอย่างสมบูรณ์ ด้วยการใช้ การ์ดที่ปรับเปลี่ยนได้ คุณสามารถออกแบบและรวม UI ที่มีน้ําหนักเบาสําหรับแพลตฟอร์มและเฟรมเวิร์กหลักทั้งหมดได้

Copilot Studio สนับสนุนการแปลข้อความคงที่ในอะแดปทีฟการ์ดผ่านไฟล์การแปล JSON/ResX เดียวกันกับที่คุณใช้สําหรับหัวข้อต่าง ๆ

บทความนี้อธิบายเวิร์กโฟลว์การแปลเป็นภาษาท้องถิ่น วิธีการแปลข้อความอะแดปทีฟการ์ด และวิธีการจัดการเนื้อหาผสมที่มีทั้งค่าคงที่และค่าไดนามิก

ก่อนที่คุณจะเริ่มต้น

ทําความคุ้นเคยกับแนวคิดต่อไปนี้:

• การสร้างและแก้ไขหัวข้อ และการใช้ตัว แก้ไขโค้ด ใน Copilot Studio
• การส่งออกและการนําเข้าไฟล์การแปลเป็นภาษาท้องถิ่น
• การใช้อะแดปทีฟการ์ด

ทําความเข้าใจเวิร์กโฟลว์การแปลเป็นภาษาท้องถิ่น

Copilot Studio มีข้อความอะแดปทีฟการ์ดแบบคงที่ทั้งหมดในไฟล์การแปลเป็นภาษาท้องถิ่นที่ส่งออกของคุณ ข้อความนี้ประกอบด้วย:

• TextBlock ค่า
• ชื่อของปุ่ม
• ข้อความตัวอย่าง
• ข้อความแสดงข้อผิดพลาด
• ข้อความกำกับภาพ

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

วิธีข้อความอะแดปทีฟการ์ดแบบคงที่ปรากฏในไฟล์การแปลเป็นภาษาท้องถิ่น

เมื่อคุณส่งออกไฟล์เพื่อนำไปใช้ในการแปลเป็นภาษาท้องถิ่นสำหรับภาษารอง ข้อความที่อยู่บนการ์ดแบบคงที่จะปรากฏเป็นรายการควบคู่กับสตริงของหัวข้อของคุณ

รายการแต่ละรายการประกอบด้วยเส้นทางคีย์ที่ไม่ซ้ํากันที่ระบุตําแหน่งที่มีข้อความในกล่องโต้ตอบ หัวข้อ และโครงสร้างการ์ด แม้ว่าคีย์จะอย่างละเอียด แต่คุณจําเป็นต้องแปลค่าเท่านั้น

ตัวอย่าง (ถูกตัดทอน):

{
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.body[0].text": "Purchase request",
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.body[2].columns[0].items[0].text": "Requested by",
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.body[2].columns[1].items[0].text": "Department",
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.body[3].facts[0].title": "Request ID",
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.body[3].facts[1].title": "Total",
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.actions[0].title": "Approve",
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.actions[1].title": "Reject",
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.actions[2].title": "View details"
}

จัดการสตริงเนื้อหาผสมด้วย SetTextVariable

บางสตริงในอะแดปทีฟการ์ดประกอบด้วยการรวมกันของข้อความคงที่และค่าไดนามิก ตัวอย่างเช่น:

คุณกําลังอนุมัติคําขอ PR-20417 เป็นจำนวน $1,245.80 สำหรับการวิจัยของ Contoso

รหัสคําขอ จํานวนรวม และหน่วยธุรกิจเป็นตัวแปร ข้อความรอบข้างต้องการการแปล Copilot Studio ไม่สามารถแยกข้อความคงที่จากเนื้อหาผสมได้โดยอัตโนมัติ ดังนั้นค่าเหล่านี้จะไม่ปรากฏในไฟล์การแปลเป็นภาษาท้องถิ่น

ใช้โหนดตัวแปรข้อความตั้งค่าสําหรับเนื้อหาผสมที่สามารถแปลได้

Copilot Studio มีโหนด ตัวแปรตั้งค่าข้อความ ที่พร้อมใช้งานผ่านตัวแก้ไขโค้ดเท่านั้น โหนดนี้ให้คุณทำสิ่งต่อไปนี้ได้:

• รวมข้อความคงที่และตัวแทนตัวแปร
• สร้างสตริงเดียวที่ปรากฏในไฟล์การแปลเป็นภาษาท้องถิ่น
• รักษาโครงสร้างตัวแปรในระหว่างการแปล

เรียนรู้เพิ่มเติมใน สร้างเนื้อหาแบบไดนามิกจากอะแดปทีฟการ์ดที่พร้อมใช้งานสําหรับการแปลเป็นภาษาท้องถิ่น

ส่งออกไฟล์การแปลเป็นภาษาท้องถิ่นของคุณและแปลข้อความคงที่

เมื่อคุณดาวน์โหลดไฟล์การแปลเป็นภาษาท้องถิ่น ไฟล์จะประกอบด้วยสตริงเนื้อหาผสมเต็มรูปแบบที่มีตัวแทนข้อความ

ตัวอย่างเช่น:

{
  "'dialog(copilots_header_392e9.topic.recommendbooks)'.'trigger(main)'.'action(readingProgress)'.Value":
    "You are approving request {Topic.requestId} totaling {Topic.formattedTotal} for {Topic.businessUnit}"
}

แปลเฉพาะข้อความคงที่และรักษาตัวแทนตัวแปรไว้ไม่เปลี่ยนแปลง

ประเด็นสำคัญ

• ข้อความอะแดปทีฟการ์ดแบบคงที่จะปรากฏในไฟล์การแปลเป็นภาษาท้องถิ่น เพื่อให้คุณสามารถแปลเนื้อหาทั้งหมดที่ผู้ใช้เชื่อมต่ออยู่เสมอ
• อะแดปทีฟการ์ดไม่จําเป็นต้องมีหลายเวอร์ชันหรือนิพจน์เงื่อนไขสําหรับประสบการณ์การใช้งานแบบหลายภาษา
• ใช้โหนด ตัวแปรตั้งค่าข้อความ สําหรับเนื้อหาคงที่และแบบไดนามิกแบบผสมเพื่อให้แน่ใจว่าตัวแทนข้อความและข้อความโดยรอบสามารถแปลเป็นภาษาท้องถิ่นได้อย่างสมบูรณ์

เวิร์กโฟลว์แบบรวมนี้ช่วยลดความซับซ้อนของกระบวนการแปลเป็นภาษาท้องถิ่น และทําให้ง่ายต่อการสร้างประสบการณ์ของผู้ใช้ที่พร้อมใช้ทั่วโลกใน Copilot Studio

ข้อมูลที่เกี่ยวข้อง

• การใช้งาน การ์ดที่ปรับเปลี่ยนได้ ใน Copilot Studio
• ถามด้วยการ์ดที่ปรับเปลี่ยนได้
• กำหนดค่าและสร้างเอเจนต์หลายภาษา
• ใช้ตัวแก้ไขโค้ดเพื่อแก้ไขหัวข้อ