เริ่มต้นใช้งาน Perspective API

เริ่มต้นใช้งาน Perspective API

เกี่ยวกับ Codelab นี้

อัปเดตล่าสุดเมื่อ มี.ค. 10, 2022

เขียนโดย Jigsaw

1 ข้อควรทราบก่อนที่จะเริ่มต้น

Perspective API คือ API ฟรีที่ช่วยให้คุณจัดการการสนทนาที่ดีขึ้นทางออนไลน์ API จะใช้แมชชีนเลิร์นนิง (ML) เพื่อวิเคราะห์สตริงข้อความและคาดการณ์ผลกระทบที่อาจมีต่อการสนทนา

คุณตั้งค่า Perspective API ใน Codelab นี้ได้

หมายเหตุ: Perspective API มีไว้เพื่อช่วยให้การตรวจสอบเนื้อหาง่ายขึ้น แต่ไม่ได้แทนที่งานของผู้มีอํานาจตัดสินใจโดยสมบูรณ์

สิ่งที่คุณจะได้เรียนรู้

• แนวทางที่ใช้ AI เป็นหลักในการตรวจสอบเนื้อหาที่แจ้งว่าไม่เหมาะสมทันทีที่มีการสร้างเนื้อหา

สิ่งที่ต้องมี

• บัญชี Google สําหรับการเข้าถึง Google Cloud
• ความเร็วอินเทอร์เน็ตเหมาะสม

2 เริ่มต้น

คุณต้องมีโปรเจ็กต์ Google Cloud เพื่อตรวจสอบสิทธิ์คําขอ API เพื่อเริ่มต้น

1. ใช้โปรเจ็กต์ที่มีอยู่ใน Google Cloud Console
2. หากจําเป็น ให้ทําตามขั้นตอนต่อไปนี้เพื่อสร้างโปรเจ็กต์ใหม่

• ลงชื่อเข้าใช้ด้วยบัญชี Google
• เปิด Cloud Console
• คลิกสร้างโปรเจ็กต์หรือเปิดเมนูเลือกโปรเจ็กต์ แล้วคลิกโปรเจ็กต์ใหม่ในกล่องโต้ตอบ
• ตั้งชื่อโปรเจ็กต์แล้วคลิกสร้าง

ตอนนี้โปรเจ็กต์จะปรากฏในเมนูแบบเลื่อนลง

ขอสิทธิ์เข้าถึง API

• หากต้องการขอสิทธิ์เข้าถึง API โปรดกรอกแบบฟอร์มนี้

คุณควรได้รับอีเมลที่ยืนยันว่าคุณจะดูและเปิดใช้ API ใน Google Cloud ได้ภายใน 1 ชั่วโมง

หมายเหตุ: หากไม่ได้รับอีเมลภายใน 1 วันทําการ ให้กรอกแบบฟอร์มอีกครั้งหรือติดต่อทีมสนับสนุน

3 เปิดใช้ API

• ใน Cloud Console ให้ไปที่หน้าภาพรวมของ Perspective API แล้วคลิกเปิดใช้

4 สร้างคีย์ API

1. ในเมนูการนําทาง ให้คลิก API & &;; Services > Credentials > สร้างข้อมูลเข้าสู่ระบบ > คีย์ API

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

คีย์ API ควรใช้งานได้ภายในไม่กี่นาที แต่อาจใช้เวลาถึง 1 ชั่วโมง ในระหว่างนี้คุณอาจได้รับข้อความแสดงข้อผิดพลาด

2. คัดลอกคีย์ API

5 คำขอตัวอย่าง

คุณสามารถสร้างไลบรารีของไคลเอ็นต์ API ด้วยไลบรารีของไคลเอ็นต์ Google API ตัวอย่างต่อไปนี้แสดงวิธีการตั้งค่าไลบรารี API ด้วยภาษาที่พบบ่อยที่สุด

1. ส่งคําขอ AnalyzeComment
2. เรียกใช้การเรียก API ตัวอย่างรายการใดรายการหนึ่งนี้เพื่อรับคะแนนจาก Perspective API โดยตรง

เมธอด AnalyzeComment จะส่งคําขอ API เพื่อวิเคราะห์ช่อง comment.text สําหรับ requestedAttributes ในกรณีนี้ โมเดล TOXICITY

3. วางคีย์ API ในช่อง API_KEY

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

4. อ่านเอกสารอ้างอิง API เพื่อดูรายละเอียดเกี่ยวกับช่องคําขอและการตอบกลับทั้งหมด รวมถึงค่าที่ใช้ได้กับ requestedAttributes

มีแอตทริบิวต์ทดลอง เช่น OBSCENE, ATTACK_ON_SITES และ SPAM ที่คุณอาจใช้ด้วย

Python

ตัวอย่างคําขอและการตอบกลับนี้ใช้ไลบรารีของไคลเอ็นต์ Google API เวอร์ชัน Python

1. ติดตั้งไลบรารีของไคลเอ็นต์ Python
2. เรียกใช้คําสั่งเหล่านี้

คุณควรจะเห็นผลลัพธ์ในรูปแบบนี้

คําทักทายที่เป็นมิตรของคุณได้คะแนนต่ําเป็นพิษ

Node.js

ตัวอย่างคําขอและการตอบกลับนี้ใช้ไลบรารีของไคลเอ็นต์ Google API เวอร์ชัน Node.js

1. ติดตั้งไลบรารีของไคลเอ็นต์ Node.js หรือติดตั้งแพ็กเกจ npm googleapis
2. เรียกใช้คําสั่งเหล่านี้

คุณควรจะเห็นผลลัพธ์ในรูปแบบนี้

URL

ตัวอย่างคําขอและการตอบกลับนี้ใช้คําสั่ง cURL คําสั่งนี้ควรใช้ได้ผลสําหรับผู้ใช้ MacOS และ Linux ส่วนใหญ่ คุณอาจต้องติดตั้ง cURL เพื่อเรียกใช้คําสั่งนี้

• แทนที่ YOUR_KEY_HERE ด้วยคีย์ API ของคุณ

ในคําตอบนี้ ช่อง attributeScores.TOXICITY.summaryScore.value จะให้คะแนนความเป็นพิษ&#39 สําหรับความคิดเห็น ความคิดเห็นได้คะแนน 0.9 จาก 1.0

6 ยินดีด้วย

คุณได้เริ่มต้นใช้งาน Perspective API แล้ว

ดูข้อมูลเพิ่มเติม

• เว็บไซต์ Perspective API มีข้อมูลเพิ่มเติมเกี่ยวกับ API รวมถึงกรณีศึกษา
• เว็บไซต์ของนักพัฒนาซอฟต์แวร์ Perspective API มีข้อมูลเพิ่มเติมเกี่ยวกับแอตทริบิวต์ ภาษา และวิธีการ หากต้องการเริ่มต้นอย่างรวดเร็ว หน้าวิธีการอธิบายวิธีใช้ AnalyzeComment และ SuggestCommentScore