AgentPlaybooks

将工作或上下文层级中的记忆归档到长期。条目被保留，而不是删除；过滤器（键、标签、from_tier、older_than_hours）以AND组合。需要memory:write或完全权限。使用delete_memory进行不可逆删除，使用promote_memory将键向另一个方向移动，当您还需要父摘要时使用consolidate_memories。将playbook_id作为此调用应针对的剧本的UUID或GUID传递。

将相关记忆整合到带有摘要的新父记忆下。子行保持可读；默认情况下，它们被归档到长期层级而不是删除。需要memory:write或完全权限。仅当键应被销毁时使用delete_memory，使用archive_memories将条目移至长期而不创建父级。将playbook_id作为此调用应针对的剧本的UUID或GUID传递。

设置剧本的单例角色名称和系统提示。这不会添加第二个角色；它是一个向后兼容的别名，覆盖这些字段。需要personas:write或完全权限。更改部分字段时，优先使用update_persona。仅当您还需要更改剧本名称、可见性、配置或项目说明时，才使用update_playbook。除非您打算重置为默认助手，否则不要使用delete_persona。

为单例角色、技能和记忆创建新的剧本容器。每次调用都会插入一个新剧本；不会按名称进行upsert。需要playbooks:write或完全权限。使用update_playbook来更改现有剧本，而不是此工具。

在一次调用中创建分层任务计划：父计划记忆加上每个子任务的子节点。按键upsert，因此重复相同的plan_key会覆盖先前的图。需要memory:write或完全权限。使用write_memory创建单个节点，使用update_task_status将节点移动通过pending/running/completed，使用get_memory_tree检查图。将playbook_id作为此调用应针对的剧本的UUID或GUID传递。

从此剧本中按键永久删除一个记忆条目。该行从存储中移除，不会移动到其他层级，且无法恢复。需要具有memory:write或完全权限的凭据。使用archive_memories将条目保留在长期层级，或使用consolidate_memories在父摘要下保留子细节。当您只想隐藏已完成的工作时，不要调用此工具。将playbook_id作为此调用应针对的剧本的UUID或GUID传递。

将剧本的单例角色重置为默认助手名称和系统提示。尽管名称中有delete_*，但这并不是硬删除：每个剧本始终只保留一个逻辑角色，因此字段被覆盖而不是删除。persona_id必须等于playbook_id，因为角色存储在剧本行上。自定义名称、系统提示和元数据将被永久替换，无法撤销。需要personas:write或完全权限。使用update_persona更改字段而不重置，使用create_persona设置新身份，仅在应删除整个剧本时使用delete_playbook。

永久删除剧本及其所有内容（角色、技能、记忆、API密钥、画布和机密）。此操作无法撤销。需要playbooks:write或完全权限，且只有所有者才能删除。不要使用此工具重置角色（delete_persona）或删除单个技能或记忆；这些有专门的工具。

通过关键字搜索此剧本的完整工具目录：内置剧本工具（记忆、技能、画布、工作流运行、机密）以及每个连接服务器的联合工具（名称如supabase__execute_sql或cloudflare__search）。匹配工具名称和描述；名称匹配排名高于描述匹配。返回最多`limit`（默认10，最大25）个条目，包含名称、描述和完整输入模式。即使返回的工具不在tools/list中，也可以直接按名称调用——广告列表是一个视图，而不是边界，除非此连接使用?toolset=固定。只读且无副作用。当您需要的工具不在当前列表中时，在断定缺少能力之前使用此工具。将playbook_id作为此调用应针对的剧本的UUID或GUID传递。

获取记忆的上下文优化视图：完整的工作记忆，上下文的摘要，以及仅长期的关键字。只读。使用此工具打包提示；使用read_memory获取单个键，使用search_memory过滤，使用get_memory_tree获取父子任务图。将playbook_id作为此调用应针对的剧本的UUID或GUID传递。

获取记忆的分层树，显示父子关系和每个节点的状态。只读。使用此工具可视化任务图；使用search_memory过滤平面列表，使用get_memory_context获取分层提示视图，使用read_memory获取单个键的完整值。将playbook_id作为此调用应针对的剧本的UUID或GUID传递。

获取剧本及其单例角色、技能、连接的MCP服务器和记忆。这是唯一的角色检索工具；没有get_persona。只读。需要playbooks:read或完全权限。先使用list_playbooks发现ID，当您需要单个技能的完整内容而不是剧本摘要时，使用get_skill。

返回此剧本中一个技能的完整定义，包括名称、描述、内容、优先级和附件。使用skill_id标识技能，可以是UUID或技能的kebab-case名称。此查找不会修改技能。先使用list_skills发现ID和名称。不要使用list_skill_versions（历史修订）或get_playbook（角色和摘要，不是完整技能内容）。将playbook_id作为此调用应针对的剧本的UUID或GUID传递。

列出由认证用户拥有或与其共享的剧本，包括访问角色和内容计数。只读；不会创建或修改剧本。当您需要单个剧本的单例角色、技能、连接的服务器和记忆时，请使用get_playbook。需要playbooks:read或完全权限。

列出当前附加到此剧本的每个技能，返回id、名称、描述、内容、许可证和优先级，按优先级降序排列。只读；不会创建或更改技能。在get_skill、update_skill或delete_skill之前，使用此工具发现skill_id值。不要使用list_skill_versions（列出单个技能的历史修订）或get_playbook（仅总结技能）。将playbook_id作为此调用应针对的剧本的UUID或GUID传递。

将记忆提升到更高层级或提高其优先级以供活动使用。此工具不能降级；使用archive_memories将工作或上下文条目移至长期。使用priority_boost重复调用会再次增加优先级。需要memory:write或完全权限。将playbook_id作为此调用应针对的剧本的UUID或GUID传递。

按键读取一个记忆条目，并返回其值、标签、层级、摘要和元数据。这不是纯粹的读取：它会增加access_count并更新last_accessed_at作为副作用，而不更改存储的值。没有update_memory；使用write_memory覆盖键。使用search_memory查找键，使用get_memory_context获取分层摘要，或使用get_memory_tree获取分层任务图。不要传递memory_type；该过滤器属于search_memory。将playbook_id作为此调用应针对的剧本的UUID或GUID传递。

按文本、标签、层级或类型搜索记忆。返回大型记忆的摘要。使用标签进行分类搜索；使用层级关注活动与存档数据；使用memory_type查找任务图。除了返回匹配项外，只读；不会写入条目。使用read_memory获取单个键，使用get_memory_context获取紧凑的分层视图，使用get_memory_tree获取父子任务图。将playbook_id作为此调用应针对的剧本的UUID或GUID传递。

更新单例角色的名称、系统提示或元数据，而不重置为默认值。persona_id必须等于playbook_id，因为角色存储在剧本行上。需要personas:write或完全权限。使用create_persona同时替换名称和系统提示，使用delete_persona重置为默认助手，并在同时更改剧本级字段时使用update_playbook。

按键创建或覆盖记忆条目。没有单独的update_memory；对同一键的第二次写入将替换先前的值且无法撤销。对活动任务使用tier='working'，对背景上下文使用'contextual'，对已完成工作使用'longterm'。设置memory_type='hierarchical'和parent_key以构建任务图。需要memory:write或完全权限。使用delete_memory删除键，使用archive_memories将其移至长期而不删除，使用read_memory获取而不替换。将playbook_id作为此调用应针对的剧本的UUID或GUID传递。