Google AI Studio Playground มีอินเทอร์เฟซแบบภาพเพื่อสร้างต้นแบบและเรียนรู้วิธีสร้าง Agent ที่มีการจัดการโดยไม่ต้องสร้างและเขียนการเรียก API
หากต้องการเริ่มต้นใช้งาน ให้ไปที่แท็บ Playground ในแผงการนำทางของ Google AI Studio แล้วเปลี่ยนปุ่มเปิด/ปิดเป็น Agents
เทมเพลตที่สร้างไว้ล่วงหน้า
แท็บ Agents มีชุดเทมเพลตที่กำหนดค่า Agent Antigravity พื้นฐานไว้ล่วงหน้าโดยการตั้งค่าเครื่องมือและการกำหนดค่าสภาพแวดล้อม เทมเพลตทั้งหมดเป็นโอเพนซอร์สและเผยแพร่ภายใต้ ที่เก็บ google-gemini/gemini-managed-agents-templates การสำรวจเทมเพลตเหล่านี้เป็นวิธีที่ยอดเยี่ยมในการเรียนรู้วิธีสร้างและจัดโครงสร้าง Agent ที่มีการจัดการของคุณเอง
ตัวอย่างเช่น เมื่อคุณเลือกเทมเพลต AI Radio ระบบจะเปิดใช้เครื่องมือที่อนุญาตทั้งหมด และลิงก์ไฟล์ AGENTS.md และทักษะเฉพาะสำหรับการผลิตรายการวิทยุ คุณสามารถดูการตั้งค่าเหล่านี้ใน UI ของ Playground ในส่วนสภาพแวดล้อม โดยคลิกปุ่มแหล่งที่มา
การกำหนดค่าเครื่องมือ
ในการตั้งค่า Agent ใน Playground คุณสามารถเปิด/ปิดสิทธิ์เข้าถึงเครื่องมือในตัวต่อไปนี้ได้
- Google Search: เข้าถึงเว็บแบบเปิดเพื่อรับข้อมูลแบบเรียลไทม์
- บริบท URL: ดึงและแยกวิเคราะห์เนื้อหาข้อความของ URL เว็บเพจที่เฉพาะเจาะจง
- การดำเนินการโค้ด: เรียกใช้คำสั่ง Bash และ Python ได้โดยตรงภายในสภาพแวดล้อมแซนด์บ็อกซ์ที่แยกไว้
- เครื่องมือระบบไฟล์: อ่าน เขียน แสดงรายการ และลบไฟล์ภายในพื้นที่ทำงาน
การกำหนดค่าสภาพแวดล้อม
Agent ที่มีการจัดการจะทำงานภายในแซนด์บ็อกซ์ Linux ชั่วคราวที่ปลอดภัย (สภาพแวดล้อม) ซึ่งมีพื้นที่ทำงานและเครื่องมือที่ Agent จำเป็นต้องใช้ ดูข้อมูลเพิ่มเติมได้ที่คู่มือสภาพแวดล้อมของ Agent ที่มีการจัดการ
การควบคุมพฤติกรรมของ Agent
พฤติกรรม ลักษณะตัวตน และความสามารถของ Agent ส่วนใหญ่กำหนดโดยไฟล์ที่มีอยู่ในสภาพแวดล้อมของ Agent Agent จะตรวจหาและโหลดการกำหนดค่าจากโฟลเดอร์ .agents พิเศษโดยอัตโนมัติ
AGENTS.md: โหลดไว้ล่วงหน้าในบริบทของ Agent เพื่อกำหนดคำแนะนำและลักษณะตัวตนของระบบSKILL.md: อยู่ในโฟลเดอร์ทักษะที่เกี่ยวข้อง (เช่น.agents/skills/my-skill/SKILL.md) เพื่อกำหนดความสามารถและเวิร์กโฟลว์ที่เฉพาะเจาะจง
การจัดเตรียมสภาพแวดล้อม
คุณสามารถกำหนดค่าสภาพแวดล้อมที่ Agent จะใช้ได้โดยการต่อเชื่อมไฟล์กับสภาพแวดล้อมก่อนเริ่มเซสชัน คุณสามารถสร้างสภาพแวดล้อมใหม่โดยการต่อเชื่อมแหล่งที่มา หรือกู้คืนสภาพแวดล้อมก่อนหน้าก็ได้
- หากต้องการสร้างสภาพแวดล้อมใหม่ ให้คลิก เพิ่มแหล่งที่มา ในแผงการตั้งค่าสภาพแวดล้อม แล้วเลือกจากประเภทแหล่งที่มาต่อไปนี้
| ประเภทแหล่งที่มา | คำอธิบาย | เส้นทางการต่อเชื่อม |
|---|---|---|
| ไฟล์อินไลน์ | เขียนหรือวางไฟล์การกำหนดค่า ชุดข้อมูลจำลอง หรือสคริปต์ยูทิลิตี (สูงสุด 100 KB) ลงใน UI ของ Playground โดยตรง | เส้นทางปลายทางที่ผู้ใช้กำหนด (เช่น /workspace/scripts/parser.py) |
| Google Cloud Storage | ต่อเชื่อม Bucket ของ Cloud Storage แบบสาธารณะหรือส่วนตัว Bucket ส่วนตัวต้องใช้โทเค็น Bearer ของ OAuth 2.0 มาตรฐาน ดูข้อมูลเพิ่มเติมได้ที่ แหล่งที่มาส่วนตัว |
แมปเส้นทาง Bucket ของ GCS (เช่น gs://your-bucket-name/data/) กับไดเรกทอรีพื้นที่ทำงาน (เช่น /workspace/data/) |
| ที่เก็บใน GitHub | โคลนฐานของโค้ดแบบสาธารณะหรือส่วนตัว ที่เก็บส่วนตัวต้องมีการตรวจสอบสิทธิ์พื้นฐานด้วยโทเค็นเพื่อการเข้าถึงส่วนบุคคล (PAT) ของ GitHub ดูข้อมูลเพิ่มเติมได้ที่ แหล่งที่มาส่วนตัว |
โคลนลงใน /workspace/ โดยตรง (โดยปกติจะอยู่ใน /workspace/<repo-name>) |
- หากต้องการกู้คืนสภาพแวดล้อมก่อนหน้า คุณสามารถใช้รหัสสภาพแวดล้อมที่มีอยู่เพื่อโคลนและแยกสถานะที่แน่นอนของสภาพแวดล้อมนั้นได้
การใช้รหัสสภาพแวดล้อมที่มีอยู่ซ้ำ
หากคุณใช้เวลาในการตั้งค่าสภาพแวดล้อมแซนด์บ็อกซ์ไปแล้ว ก็ไม่จำเป็นต้องเริ่มต้นใหม่ วิธีใช้สภาพแวดล้อมที่มีอยู่
- ไปที่แผงสภาพแวดล้อมใน AI Studio แล้วเปลี่ยนประเภท เป็นที่มีอยู่
- ป้อนรหัสสภาพแวดล้อม (เช่น
env_abc123)
ดูข้อมูลเพิ่มเติมได้ที่หัวข้อ กำหนดค่าสภาพแวดล้อม นอกจากนี้ คุณยังดึงรหัสสภาพแวดล้อมของเซสชันปัจจุบันได้จากแท็บสภาพแวดล้อมใน UI
เมื่อคุณส่งข้อความแรกไปยัง Agent การกำหนดค่าสภาพแวดล้อมจะคงที่สำหรับเซสชันนั้น คุณจะต่อเชื่อมแหล่งที่มาใหม่หรือแก้ไขรายการที่อนุญาตของเครือข่ายไม่ได้ในขณะที่การโต้ตอบกำลังทำงานอยู่
ดาวน์โหลดสภาพแวดล้อม
เมื่อสร้างสภาพแวดล้อมแล้ว คุณสามารถดาวน์โหลดสแนปช็อตของสภาพแวดล้อมได้ทุกเมื่อโดยใช้ปุ่มดาวน์โหลด ในการตั้งค่าสภาพแวดล้อมของ AI Studio Playground เพื่อดึงไฟล์สภาพแวดล้อมเป็นไฟล์ tarball
การจัดการความปลอดภัยและค่าใช้จ่าย
การจัดการการใช้โทเค็น
Agent Antigravity จะดำเนินการเวิร์กโฟลว์อัตโนมัติ ซึ่งแตกต่างจากคำขอแชทมาตรฐานที่สร้างเอาต์พุตเดียว โดยจะวางแผน เรียกใช้โค้ด สังเกตผลลัพธ์ และทำซ้ำ ซึ่งหมายความว่าพรอมต์เดียวอาจทำให้เกิดการใช้โทเค็นแบบไม่จำกัด
ระบุเกณฑ์การสิ้นสุดที่ชัดเจนในพรอมต์และจำกัดขอบเขตงานให้แคบลงสำหรับ Agent เพื่อจัดการค่าใช้จ่าย ตัวอย่างที่ดีคือพรอมต์ เช่น ตรวจสอบ Pull Request และหยุดเมื่อสร้างสรุป Markdown แล้ว อย่าพยายามเขียนการแก้ไขด้วยตนเอง
ค่าใช้จ่ายเพิ่มเติม
โดยค่าเริ่มต้น เทมเพลต Agent ทั้งหมดใน Playground จะมีสิทธิ์เข้าถึงบริการ Gemini API และสามารถเรียกใช้ API จากสภาพแวดล้อมเพื่อทำตามคำขอได้ ซึ่งอาจทำให้เกิดค่าใช้จ่ายเพิ่มเติมซึ่งจะไม่แสดงในการใช้โทเค็น
ในทำนองเดียวกัน หากคุณเพิ่มบริการภายนอกอื่นๆ Agent อาจทำให้เกิดค่าใช้จ่ายเพิ่มเติมโดยการเรียกใช้บริการเหล่านี้ในนามของคุณ
รายการที่อนุญาตของเครือข่าย
โดยค่าเริ่มต้น ใน AI Studio ระบบจะควบคุมและจำกัดคำขอเครือข่ายขาออกจากสภาพแวดล้อมแซนด์บ็อกซ์ของ Agent อย่างเข้มงวดเพื่อให้มั่นใจในความปลอดภัย หากต้องการให้สิทธิ์ Agent ในการเข้าถึง API ภายนอก เว็บเซอร์วิส หรือตัวจัดการแพ็กเกจ คุณต้องประกาศอย่างชัดเจนดังนี้
- ไปที่แผงสภาพแวดล้อมใน AI Studio
- เลือกปุ่มกฎ ข้างเครือข่าย
- ในแผงการกำหนดค่าเครือข่าย ให้คลิกเพิ่มลงในรายการที่อนุญาต แล้วกรอกรายละเอียดที่เกี่ยวข้อง ดังนี้
- การจำกัดโดเมน: เครื่องเสมือนของ Agent จะเข้าถึงได้เฉพาะโดเมนหรือรูปแบบไวลด์การ์ดที่เฉพาะเจาะจงซึ่งเพิ่มลงในรายการ ตัวอย่างเช่น คุณสามารถป้อนโดเมนที่แน่นอน เช่น
api.github.comหรือรูปแบบกว้างๆ เช่น*.googleapis.com - เพิ่มส่วนหัว HTTP และการแทรกโทเค็น: ใช้ตัวเลือกเพิ่มส่วนหัว HTTP เพื่อแทรกข้อมูลเข้าสู่ระบบที่จำเป็น (เช่น โทเค็น API) สำหรับโดเมนที่เฉพาะเจาะจงอย่างปลอดภัย ข้อมูลเข้าสู่ระบบเหล่านี้จะส่งผ่านพร็อกซีขาออกอย่างปลอดภัยและจะไม่แสดงเป็นข้อความธรรมดาภายในแซนด์บ็อกซ์ของ Agent โดยตรง
- การจำกัดโดเมน: เครื่องเสมือนของ Agent จะเข้าถึงได้เฉพาะโดเมนหรือรูปแบบไวลด์การ์ดที่เฉพาะเจาะจงซึ่งเพิ่มลงในรายการ ตัวอย่างเช่น คุณสามารถป้อนโดเมนที่แน่นอน เช่น
โปรดใช้ความระมัดระวังเสมอเมื่อเพิ่มโดเมนลงในรายการที่อนุญาต การให้สิทธิ์ Agent เข้าถึงบริการที่ต้องมีการตรวจสอบสิทธิ์หมายความว่า Agent สามารถดำเนินการในนามของคุณได้ ซึ่งอาจนำไปสู่การดำเนินการที่ไม่พึงประสงค์หากไม่ได้รับการตรวจสอบอย่างละเอียด
แนวทางปฏิบัติแนะนำสำหรับข้อมูลเข้าสู่ระบบ
หากเวิร์กโฟลว์กำหนดให้ Agent ต้องตรวจสอบสิทธิ์กับบริการภายนอก คุณมีหน้าที่รับผิดชอบในการจัดเตรียมและกำหนดขอบเขตข้อมูลเข้าสู่ระบบเหล่านั้น ทำตามหลักเกณฑ์ต่อไปนี้เพื่อลดความเสี่ยง
- ใช้ข้อมูลเข้าสู่ระบบที่มีสิทธิ์ขั้นต่ำที่สุด: สร้างบัญชีบริการหรือคีย์ API ที่มีเฉพาะสิทธิ์ที่ Agent ต้องการ หลีกเลี่ยงการส่งข้อมูลเข้าสู่ระบบที่มีสิทธิ์เข้าถึงแบบกว้างหรือสิทธิ์เข้าถึงระดับผู้ดูแลระบบ
- ใช้โทเค็นที่มีอายุสั้น: ใช้ข้อมูลเข้าสู่ระบบหรือโทเค็นที่มีการจำกัดเวลาหรือหมดอายุแทนคีย์ API ที่มีอายุยาวนาน หากเป็นไปได้
- ถือว่ามีสิทธิ์เข้าถึงแบบเต็ม: Agent อาจใช้ข้อมูลเข้าสู่ระบบที่เข้าถึงได้เพื่อทำงานที่คุณมอบหมายให้เสร็จสมบูรณ์ ให้เฉพาะข้อมูลเข้าสู่ระบบที่คุณยินดีให้สิทธิ์เข้าถึงแบบเต็ม
- หมุนเวียนข้อมูลเข้าสู่ระบบเป็นประจำ: จัดการข้อมูลเข้าสู่ระบบที่แชร์กับ Agent ในลักษณะเดียวกับที่คุณจัดการข้อมูลเข้าสู่ระบบแบบเป็นโปรแกรม โดยหมุนเวียนข้อมูลเข้าสู่ระบบตามกำหนดเวลาปกติ
การเชื่อมต่อเครื่องมือและ API ภายนอก
คุณสามารถเชื่อมต่อเครื่องมือและ API ภายนอก (เช่น เซิร์ฟเวอร์ Model Context Protocol / MCP) เพื่อขยายความสามารถของ Agent โดยมีข้อควรระวังดังนี้
- เชื่อมต่อเครื่องมือจากแหล่งที่มาที่คุณเชื่อถือเท่านั้น เครื่องมือที่เป็นอันตรายหรือเขียนมาไม่ดีอาจเปิดเผยข้อมูลหรือดำเนินการที่ไม่พึงประสงค์
- กำหนดค่าเครื่องมือด้วยสิทธิ์ขั้นต่ำที่จำเป็นสำหรับกรณีการใช้งานของคุณ หากเครื่องมือรองรับโหมดอ่านอย่างเดียว ให้ใช้โหมดดังกล่าว เว้นแต่ว่าจำเป็นต้องมีการเขียน
- ทดสอบเครื่องมือกับข้อมูลตัวอย่างหรือข้อมูลสังเคราะห์ก่อนเชื่อมต่อเครื่องมือกับแหล่งข้อมูลการใช้งานจริง เพื่อยืนยันว่า Agent ใช้เครื่องมือตามที่คาดไว้
การกำกับดูแลจากเจ้าหน้าที่
Agent สามารถให้เหตุผล วางแผน และดำเนินการเวิร์กโฟลว์แบบหลายขั้นตอนได้อย่างอิสระในระดับสูง แม้ว่าจะมีประสิทธิภาพ แต่ก็หมายความว่าคุณควรมีการกำกับดูแลที่เหมาะสม โดยเฉพาะอย่างยิ่งสำหรับงานที่แก้ไขข้อมูลหรือโต้ตอบกับระบบภายนอก
ตรวจสอบเอาต์พุตที่สำคัญเสมอ เช่น โค้ดที่สร้างขึ้น การแปลงข้อมูล หรือการเปลี่ยนแปลงการกำหนดค่าก่อนที่จะนำไปใช้