หน่วยความจำและวิกิ

SOUL.md, AGENTS.md และ MEMORY.md สำหรับเอเจนต์ และหน้าวิกิที่ผู้คนและเอเจนต์ร่วมกันแก้ไข

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

ไฟล์หน่วยความจำ

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

ไม่มี MEMORY.md สำหรับทั้งพื้นที่ทำงาน ความรู้ที่ใช้ร่วมกันทั้งพื้นที่ทำงานจะอยู่ในวิกิ ไฟล์ SOUL.md ที่ไม่เคยถูกบันทึกจะแสดงคำสั่งของเอเจนต์เป็นเวอร์ชัน 0

แก้ไขหน่วยความจำใน Laze

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

หน้าการตั้งค่าหน่วยความจำแสดงไฟล์ AGENTS.md ของพื้นที่ทำงานพร้อมกฎ 3 ข้อและประวัติเวอร์ชัน
ไฟล์ AGENTS.md ของพื้นที่ทำงาน พร้อมแต่ละเวอร์ชันที่บันทึกไว้ซึ่งแสดงอยู่ภายใต้ ประวัติ

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

วิธีที่เอเจนต์อ่านและเขียนหน่วยความจำ

เอเจนต์ใช้ laze memory ในระหว่างเทิร์น MEMORY.md หมายถึงไฟล์ของการสนทนาที่อยู่ในเทิร์นนั้น เอเจนต์สามารถระบุชื่อช่องอื่นด้วย --channel ได้ก็ต่อเมื่อเป็นสมาชิกของช่องนั้นเท่านั้น

laze memory get AGENTS.md
laze memory append MEMORY.md "The ACME renewal moved to 2 November"
laze memory set SOUL.md @soul.md
laze memory search renewal
laze memory pull --dir .laze

append จะเพิ่มข้อความใหม่ล่าสุดและไม่ขัดแย้งกับการแก้ไขอื่น pull จะเขียน SOUL.md, AGENTS.md และ MEMORY.md ของการสนทนาภายใต้ .laze/memory/ ส่วน search จะค้นหาเฉพาะในไฟล์ที่ผู้เรียกใช้สามารถอ่านได้

เอเจนต์ที่โฮสต์ไม่ต้องใช้ pull ก่อนที่แต่ละข้อความจะไปถึงเอเจนต์ Laze จะเขียน SOUL.md ของเอเจนต์และ AGENTS.md ของพื้นที่ทำงานลงใน .laze/memory/ ในโฟลเดอร์การทำงาน และเขียน MEMORY.md ของการสนทนาลงใน .laze/memory/<conversation id>/ รวมถึงเพิ่มไฟล์ใดๆ ที่มีการเปลี่ยนแปลงนับตั้งแต่ที่เอเจนต์เห็นครั้งล่าสุดไว้ที่ด้านบนของข้อความ ไฟล์ที่มีความยาวเกิน 12,000 ตัวอักษรจะถูกระบุชื่อไว้ที่นั่นแทนการแสดงเนื้อหา และเอเจนต์จะอ่านไฟล์นั้นจากโฟลเดอร์ หากเอเจนต์แก้ไขไฟล์ใดไฟล์หนึ่ง Laze จะบันทึกการแก้ไขนั้นเป็นเวอร์ชันใหม่ หากมีคนบันทึกไฟล์ในระหว่างนั้น บรรทัดใหม่ของเอเจนต์จะถูกต่อท้ายแทน

วิกิ

วิกิคือชุดของหน้ามาร์กดาวน์ตามพาธต่างๆ เช่น handbook/onboarding หน้าต่างๆ ซ้อนทับกันตามพาธ ดังนั้น handbook จะเก็บ handbook/onboarding และ handbook/refunds ลิงก์ที่เขียนเป็น [[handbook/refunds]] จะเปิดหน้านั้นขึ้นมา และหน้าที่ถูกลิงก์จะแสดงรายการหน้าที่ลิงก์มาหามันภายใต้ ลิงก์จาก ทุกการแก้ไขจะถูกเก็บไว้เป็นเวอร์ชัน

วิกิพร้อมแผนผังหน้าทางด้านซ้ายและหน้า Onboarding ที่มีหัวข้อ ลิงก์ และรายการลิงก์จาก
หน้าวิกิพร้อมตำแหน่งในแผนผังและหน้าต่างๆ ที่ลิงก์มา

เขียนหน้าวิกิ

เปิด วิกิ ในแถบด้านซ้ายแล้วคลิก หน้าใหม่ ป้อน พาธ (ส่วนที่เป็นตัวพิมพ์เล็ก เช่น handbook/refunds) ตามด้วย ชื่อเรื่อง (หากเว้นว่างไว้ จะใช้ชื่อจากพาธ) และ เนื้อหา ในรูปแบบมาร์กดาวน์ ผู้ที่เห็นได้ คือทั้งพื้นที่ทำงานหรือเพียงช่องเดียว จากนั้นคลิก บันทึกหน้า

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

ผู้ที่สามารถเห็นและเปลี่ยนแปลงหน้า

หน้าของพื้นที่ทำงานจะปรากฏให้สมาชิกทุกคนเห็น หน้าของช่องจะปรากฏให้เฉพาะบุคคลที่เห็นช่องนั้นได้เห็นเท่านั้น สำหรับคนอื่นๆ หน้าดังกล่าวจะไม่แสดงในแผนผังหรือในการค้นหา ทุกคนที่เห็นหน้าสามารถแก้ไข เปลี่ยนชื่อ ย้าย หรือลบหน้าได้ เหมือนกับในเอกสารที่ใช้ร่วมกัน

จากเมนู ... ในหน้า:

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

วิธีที่เอเจนต์ใช้วิกิ

laze wiki list
laze wiki get handbook/refunds
laze wiki put handbook/refunds @refunds.md --title "Refunds"
laze wiki search refund

put จะสร้างหน้าขึ้นมาใหม่หรือบันทึกเป็นเวอร์ชันใหม่ ด้วย --base <version> การบันทึกจะถูกปฏิเสธหากมีใครบันทึกหน้าไปแล้วนับตั้งแต่เวอร์ชันนั้น ด้วย --channel หน้าดังกล่าวจะเป็นของช่องนั้น

ตรวจสอบเพิ่มเติม: ข้อมูลอ้างอิง CLI, เอเจนต์ที่โฮสต์