แพ็กเกจ
ส่งออก แชร์ และติดตั้งเอเจนต์ในรูปแบบไฟล์เก็บถาวรแบบพกพา
หน้าที่การทำงาน
เอเจนต์, โครงสร้างโฟลเดอร์, การตั้งค่า, ความรู้ และเวิร์กโฟลว์จะถูกแปลง (serialize) เป็นไฟล์ ZIP .agentpkg เพียงไฟล์เดียวพร้อมไฟล์ Manifest, รายชื่อผู้ร่วมสร้าง และบันทึกแหล่งที่มา การติดตั้งจะมีขั้นตอน 3 ขั้นตอน ได้แก่: วางแผน (ตรวจสอบโดยไม่มีการเขียนข้อมูล), รีวิว (ตรวจสอบความถูกต้องของข้อมูลสรุป), และนำไปใช้ (เขียนข้อมูลพร้อมการตรวจสอบความปลอดภัยแบบ TOCTOU) โดยมีโหมดการแจกจ่าย 3 รูปแบบ: ส่งออกเป็นไฟล์โดยตรง, ลิงก์ส่งต่อส่วนตัวพร้อมโทเค็นการแชร์ที่หมดอายุได้ และแกลเลอรีแสดงผลงานที่คัดสรรมาพร้อมตัวอย่างการทำงานจริงที่ได้รับการตรวจสอบแล้ว
ทำไมสิ่งนี้จึงสำคัญ
เอเจนต์ที่คุณไม่สามารถย้ายได้คือเอเจนต์ที่คุณไม่ได้เป็นเจ้าของ ไฟล์เก็บถาวรแบบพกพาหมายความว่าเอเจนต์สามารถเดินทางระหว่างบัญชี เครื่องมือ และโมเดลต่างๆ ได้โดยไม่ทิ้งความรู้ไว้เบื้องหลัง และขั้นตอนการวางแผนก่อนนำไปใช้หมายความว่าการติดตั้งคือการตัดสินใจ ไม่ใช่ผลข้างเคียง
วิธีการทำงาน
ไม่มีการรั่วไหลของ ID ข้ามขอบเขตแพ็กเกจ
UUID ภายในจะถูกสร้างขึ้นใหม่ด้วย uuidv5 ในระหว่างการแปลงข้อมูล (serialization) ดังนั้นแพ็กเกจจึงไม่มีตัวระบุบัญชี ผู้เช่า (tenant) หรือโฟลเดอร์จากต้นทางติดไปด้วย
การติดตั้ง 3 ขั้นตอนพร้อมความปลอดภัยแบบ TOCTOU
ขั้นตอนวางแผนจะตรวจสอบโดยไม่มีการเขียนข้อมูล ขั้นตอนรีวิวจะตรวจสอบความถูกต้องของข้อมูลสรุป ขั้นตอนนำไปใช้จะตรวจสอบข้อมูลสรุปอีกครั้งก่อนเขียนข้อมูล หากแพ็กเกจมีการเปลี่ยนแปลงระหว่างขั้นตอนรีวิวและนำไปใช้ จะถูกปฏิเสธ
แกลเลอรีแสดงผลงานมาพร้อมตัวอย่างการทำงานจริงที่ได้รับการตรวจสอบแล้ว
เวิร์กโฟลว์ในแกลเลอรีแสดงผลงานจะรวมการทำงานจริงที่ปกปิดข้อมูลส่วนตัวไว้ เพื่อให้ผู้ใช้สามารถดูการทำงานก่อนติดตั้งได้ และจะมีการตรวจสอบความถูกต้องเมื่อแสดงผล
คำถาม
- มีอะไรอยู่ในแพ็กเกจบ้าง?
- โครงสร้างโฟลเดอร์, เอกสารปลายทางทั้งหมด, ไฟล์การตั้งค่า .context และ .agent, เวิร์กโฟลว์ และไฟล์ Manifest พร้อมข้อมูลเมตาของผู้ร่วมสร้างและแหล่งที่มา ไม่มีข้อมูลรับรอง ไม่มีเวกเตอร์ฝังตัว และไม่มีสถานะการตรวจสอบความถูกต้อง
- ฉันสามารถแชร์แพ็กเกจกับผู้ใช้ในบัญชีอื่นได้หรือไม่?
- ได้ ลิงก์ส่งต่อส่วนตัวจะมีโทเค็นการแชร์ที่หมดอายุตามเวลา ผู้รับจะติดตั้งลงในบัญชีของตนเองผ่านขั้นตอน วางแผน-รีวิว-นำไปใช้ แบบเดียวกัน
The rest of the bag
การกำหนดสิทธิ์รายเอกสารที่กรองคำตอบ ไม่ใช่แค่หน้าเว็บ
การประมวลผลนโยบายจะถูกแคชไว้ต่อเซสชันเพื่อความรวดเร็ว การเปลี่ยนแปลงสิทธิ์จะส่งผลเมื่อแคชถูกล้างข้อมูล แทนที่จะส่งผลทันทีกับทุกคำขอที่กำลังดำเนินการอยู่
ทุกโฟลเดอร์และเอกสารย่อยจะมีนโยบายการเข้าถึง: สาธารณะ, ลงชื่อเข้าใช้แล้ว, หรือได้รับการอนุมัติจากเจ้าของ นโยบายเหล่านี้จะถูกประมวลผลเป็นกรอบข้อมูลต่อเซสชันเพื่อกรองสิ่งที่เอเจนต์สามารถดึงข้อมูลได้ก่อนที่จะตอบกลับ ทะเบียนความสามารถ (capability registry) จะควบคุมฟีเจอร์ทั้งหมดตามผู้เช่า (tenant) และการตรวจสอบการเข้าถึงที่สำคัญจะถูกปิดกั้นการเข้าถึงเมื่อเกิดข้อผิดพลาด (fail closed)
เอกสาร
โครงสร้างโฟลเดอร์ที่เอเจนต์ใช้อ่าน และไฟล์กำหนดค่าที่เอเจนต์ปฏิบัติตาม
การดึงข้อมูลครอบคลุมไฟล์ PDF, สเปรดชีต และบันทึกการสนทนา ส่วนไฟล์ไบนารีรูปแบบพิเศษจะไม่ถูกแยกวิเคราะห์
เหตุการณ์
บัญชีแยกประเภทที่ทนทานซึ่งบันทึกสิ่งที่เอเจนต์ทำและเหตุผล
event bus ภายในกระบวนการ (in-process) เป็นตัวส่งสัญญาณแบบโหนดเดียว (single-node emitter) ไม่ใช่โบรกเกอร์แบบกระจายศูนย์ (distributed broker) ส่วนบันทึกข้ามเอเจนต์ที่ทนทานนั้นเป็นบัญชีแยกประเภทงาน Postgres ที่แยกต่างหาก
That was step 6 of 6: a reply leaves, and the trail stays. นั่นคือเส้นทางทั้งหมด ตั้งแต่การมาถึงไปจนถึงบันทึกที่สามารถเล่นซ้ำได้