API VEGA

Резюме

Управление пространствами Lark Wiki, участниками, узлами и иерархиями организации документов.

  • Создавать, перечислять и удалять пространства знаний; получать информацию о пространствах и узлах по токену или URL

  • Добавлять, удалять и перечислять участников пространства с поддержкой пользователей, групп и департаментов; обеспечивает ограничения по идентичности (идентичность бота не может управлять участниками департаментов)

  • Создавать, перемещать, копировать и удалять узлы wiki; упорядочивать документы и ярлыки внутри иерархий пространств

  • Предпочитает идентичность пользователя перед идентичностью бота для личных ресурсов знаний; включает механизмы безопасности для рискованных операций, таких как удаление пространства, требующее явного подтверждения пользователя

wiki (v2)

КРИТИЧЕСКОЕ — Перед началом необходимо сначала использовать инструмент Read, чтобы прочитать ../lark-shared/SKILL.md, в котором содержатся вопросы аутентификации и обработки прав доступа

Жесткие ограничения на управление участниками:

  • Если целью является «департамент», сначала определите идентичность, затем решайте, продолжать ли.

  • --as bot соответствует tenant_access_token. Официальное ограничение: при таком виде идентичности нельзя использовать идентификатор департамента (opendepartmentid) для добавления участников пространства знаний.

  • При столкновении «департамент + --as bot» запрещается сначала вызывать lark-cli wiki +member-add для проверки; прямо сообщайте, что этот путь непригоден.

  • Если пользователь ясно требует выполнения от имени bot и цель — департамент, нужно остановиться и сообщить, что путь с bot не может быть выполнен, не переходя молча к --as user.

Выбор идентичности: предпочтительно использовать идентичность пользователя

Пространства знаний и узлы являются личными ресурсами пользователя; по политике следует явно предпочитать использование --as user (значение CLI --as по умолчанию auto; если не указывать --as, часто трактуется как bot, и перечисляются пространства, принадлежащие приложению, а не пользователю). Только когда пользователь явно требует «вид приложения / bot» использовать --as bot (всё ещё под вышеуказанными жесткими ограничениями управления участниками).

Быстрые решения