Agent ใน AI Studio Playground

Google AI Studio Playground มีอินเทอร์เฟซแบบภาพสำหรับสร้างต้นแบบและเรียนรู้วิธีสร้างเอเจนต์ที่มีการจัดการโดยไม่ต้องสร้างและเขียนการเรียก API

หากต้องการเริ่มต้นใช้งาน ให้ไปที่แท็บสนามเด็กเล่นในแผงการนำทางของ Google AI Studio แล้วเปลี่ยนปุ่มเปิด/ปิดเป็นเอเจนต์

เทมเพลตที่สร้างไว้ล่วงหน้า

แท็บเอเจนต์มีชุดเทมเพลตที่ กำหนดค่า Antigravity Agent พื้นฐานล่วงหน้าโดยการตั้งค่าเครื่องมือและสภาพแวดล้อม เทมเพลตทั้งหมดเป็นโอเพนซอร์สและเผยแพร่ภายใต้ที่เก็บ google-gemini/gemini-managed-agents-templates การสำรวจเทมเพลตเหล่านี้เป็นวิธีที่ยอดเยี่ยมในการเรียนรู้วิธีสร้างและจัดโครงสร้างเอเจนต์ที่มีการจัดการของคุณเอง

เช่น เมื่อเลือกเทมเพลตวิทยุ AI ระบบจะเปิดใช้เครื่องมือที่อนุญาตทั้งหมด และลิงก์AGENTS.mdไฟล์และทักษะเฉพาะสำหรับการผลิตรายการวิทยุ คุณดูการตั้งค่าเหล่านี้ได้ใน UI ของ Playground ในส่วนสภาพแวดล้อมโดยคลิกปุ่มแหล่งที่มา

การกำหนดค่าเครื่องมือ

ในการตั้งค่าเอเจนต์ใน Playground คุณสามารถสลับการเข้าถึงเครื่องมือในตัวต่อไปนี้ได้

• Google Search: เข้าถึงเว็บแบบเปิดเพื่ออ้างอิงข้อมูลแบบเรียลไทม์
• บริบท URL: ดึงข้อมูลและแยกวิเคราะห์เนื้อหาข้อความของ URL หน้าเว็บที่เฉพาะเจาะจง
• การดำเนินการโค้ด: รันคำสั่ง Bash และ Python ได้โดยตรงภายใน สภาพแวดล้อมแซนด์บ็อกซ์ที่แยกจากกัน
• เครื่องมือระบบไฟล์: อ่าน เขียน แสดงรายการ และลบไฟล์ภายในพื้นที่ทำงาน

การกำหนดค่าสภาพแวดล้อม

เอเจนต์ที่มีการจัดการจะทำงานภายในแซนด์บ็อกซ์ Linux แบบชั่วคราวที่ปลอดภัย (สภาพแวดล้อม) ซึ่งมีพื้นที่ทำงานและเครื่องมือที่จำเป็นต่อการทำงาน ดูข้อมูลเพิ่มเติมได้ที่คู่มือสภาพแวดล้อมของเอเจนต์ที่มีการจัดการ

การควบคุมลักษณะการทำงานของเอเจนต์

ลักษณะ พฤติกรรม ตัวตน และความสามารถของเอเจนต์ส่วนใหญ่จะกำหนดโดยไฟล์ที่มีอยู่ในสภาพแวดล้อมของเอเจนต์ เอเจนต์จะตรวจหาและโหลดการกำหนดค่าจากโฟลเดอร์พิเศษ .agents โดยอัตโนมัติ

• AGENTS.md: โหลดไว้ล่วงหน้าในบริบทของ Agent เพื่อกำหนดคำสั่งของระบบและลักษณะตัวตน
• SKILL.md: อยู่ในโฟลเดอร์ทักษะที่เกี่ยวข้อง (เช่น .agents/skills/my-skill/SKILL.md) เพื่อกำหนดความสามารถและเวิร์กโฟลว์ที่เฉพาะเจาะจง

การจัดสรรสภาพแวดล้อม

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

• หากต้องการสร้างสภาพแวดล้อมใหม่ ให้คลิกเพิ่มแหล่งข้อมูลในแผงการตั้งค่าสภาพแวดล้อม แล้วเลือกจากประเภทแหล่งข้อมูลต่อไปนี้

• หากต้องการกู้คืนสภาพแวดล้อมก่อนหน้า คุณสามารถใช้รหัสสภาพแวดล้อมที่มีอยู่ซ้ำเพื่อโคลนและแยกสถานะที่แน่นอนของสภาพแวดล้อมนั้นได้

การนำรหัสสภาพแวดล้อมที่มีอยู่กลับมาใช้ซ้ำ

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

1. ไปที่แผงสภาพแวดล้อมใน AI Studio แล้วสลับประเภทเป็นมีอยู่
2. ป้อนรหัสสภาพแวดล้อม (เช่น env_abc123)

ดูข้อมูลเพิ่มเติมได้ที่กำหนดค่าสภาพแวดล้อม นอกจากนี้ คุณยังดึงข้อมูลรหัสสภาพแวดล้อมของเซสชันปัจจุบันได้จากแท็บสภาพแวดล้อมใน UI

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

ดาวน์โหลดสภาพแวดล้อม

เมื่อสร้างสภาพแวดล้อมแล้ว คุณจะดาวน์โหลดภาพรวมของสภาพแวดล้อมได้ทุกเมื่อโดยใช้ปุ่มดาวน์โหลด ในการตั้งค่าสภาพแวดล้อมของ AI Studio Playground เพื่อดึงข้อมูล ไฟล์สภาพแวดล้อมเป็นไฟล์ tarball

การจัดการความปลอดภัยและต้นทุน

การจัดการการใช้โทเค็น

ซึ่งแตกต่างจากคำขอแชทมาตรฐานที่สร้างเอาต์พุตเดียว Antigravity Agent จะดำเนินการตามเวิร์กโฟลว์อัตโนมัติ โดยจะวางแผน เรียกใช้โค้ด สังเกตผลลัพธ์ และทำซ้ำ ซึ่งหมายความว่าพรอมต์เดียวอาจทำให้มีการใช้โทเค็นไม่จำกัด

หากต้องการจัดการค่าใช้จ่าย ให้ระบุเกณฑ์การสิ้นสุดที่ชัดเจนในพรอมต์และกำหนดขอบเขต งานให้แคบลงสำหรับเอเจนต์ ตัวอย่างที่ดีอาจเป็นพรอมต์ เช่น ตรวจสอบ Pull Request และหยุดเมื่อสร้างสรุป Markdown แล้ว อย่าพยายามเขียนการแก้ไขด้วยตนเอง

ค่าใช้จ่ายเพิ่มเติม

โดยค่าเริ่มต้น เทมเพลตเอเจนต์ทั้งหมดใน Playground จะมีสิทธิ์เข้าถึงบริการ Gemini API และสามารถเรียกใช้ API จากสภาพแวดล้อมเพื่อตอบสนองคำขอได้ ซึ่งอาจมีค่าใช้จ่ายเพิ่มเติมซึ่งจะไม่แสดงในการใช้โทเค็น

ในทำนองเดียวกัน หากคุณเพิ่มบริการภายนอกอื่นๆ เอเจนต์อาจมีค่าใช้จ่ายเพิ่มเติม จากการเรียกใช้บริการเหล่านี้ในนามของคุณ

รายการที่อนุญาตของเครือข่าย

โดยค่าเริ่มต้นใน AI Studio ระบบจะควบคุมและจำกัดคำขอเครือข่ายขาออกทั้งหมดจากภายในสภาพแวดล้อมแซนด์บ็อกซ์ของเอเจนต์อย่างเข้มงวดเพื่อให้มั่นใจในความปลอดภัย หากต้องการให้ตัวแทนมีความสามารถในการเข้าถึง API ภายนอก บริการเว็บ หรือเครื่องมือจัดการแพ็กเกจ คุณต้องประกาศอย่างชัดเจนดังนี้

1. ไปที่แผงสภาพแวดล้อมใน AI Studio
2. เลือกปุ่มกฎข้างเครือข่าย
3. ในแผงการกำหนดค่าเครือข่าย ให้คลิกเพิ่มในรายการที่อนุญาต แล้วกรอกรายละเอียดที่เกี่ยวข้อง ดังนี้
   • การจำกัดโดเมน: มีเพียงโดเมนที่เฉพาะเจาะจงหรือรูปแบบไวลด์การ์ดที่เพิ่มลงในรายการเท่านั้นที่เครื่องเสมือนของตัวแทนจะเข้าถึงได้ เช่น คุณสามารถป้อนโดเมนที่แน่นอน เช่น api.github.com หรือรูปแบบกว้างๆ เช่น *.googleapis.com
   • เพิ่มส่วนหัว HTTP และการแทรกโทเค็น: ใช้ตัวเลือกเพิ่มส่วนหัว HTTP เพื่อแทรกข้อมูลเข้าสู่ระบบที่จำเป็น (เช่น โทเค็น API) สำหรับโดเมนที่เฉพาะเจาะจงอย่างปลอดภัย ข้อมูลเข้าสู่ระบบเหล่านี้จะส่งผ่านพร็อกซีขาออกอย่างปลอดภัยและจะไม่แสดงเป็นข้อความดิบภายในแซนด์บ็อกซ์ของเอเจนต์โดยตรง

โปรดระมัดระวังเสมอเมื่อเพิ่มโดเมนลงในรายการที่อนุญาต การให้สิทธิ์เข้าถึงบริการที่ผ่านการตรวจสอบสิทธิ์แก่เอเจนต์หมายความว่าเอเจนต์จะดำเนินการในนามของคุณได้ ซึ่งอาจนำไปสู่การดำเนินการที่ไม่พึงประสงค์หากไม่ได้รับการตรวจสอบอย่างรอบคอบ

แนวทางปฏิบัติแนะนำสำหรับข้อมูลเข้าสู่ระบบ

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

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

การเชื่อมต่อเครื่องมือและ API ภายนอก

คุณสามารถเชื่อมต่อเครื่องมือและ API ภายนอก (เช่น เซิร์ฟเวอร์ Model Context Protocol / MCP ) เพื่อขยายความสามารถของ Agent ได้ โดยมีข้อควรทราบดังนี้

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

การกำกับดูแลโดยมนุษย์

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

โปรดตรวจสอบเอาต์พุตที่สำคัญ เช่น โค้ดที่สร้างขึ้น การแปลงข้อมูล หรือ การเปลี่ยนแปลงการกำหนดค่าก่อนที่จะนําไปใช้