概述

# EXPLORE 模式：智能体可以自由使用只读工具（Read、Grep、Glob）
# 和只读 bash 命令（`ls`、`git status`、`cat` 等）。
# 任何修改（Write、Edit、非只读 bash 命令）都会被自动拒绝。
agent = Agent(
    name="explorer",
    system_prompt="...",
    model=model,
    state=AgentState(
        permission_context=PermissionContext(mode=PermissionMode.EXPLORE)
    ),
)

from agentscope.permission import PermissionRule, PermissionBehavior

agent = Agent(
    name="ci_agent",
    system_prompt="...",
    model=model,
    state=AgentState(
        permission_context=PermissionContext(
            mode=PermissionMode.DONT_ASK,
            allow_rules={
                "Bash": [
                    PermissionRule(tool_name="Bash", rule_content="npm run:*",
                                   behavior=PermissionBehavior.ALLOW, source="project"),
                    PermissionRule(tool_name="Bash", rule_content="git commit:*",
                                   behavior=PermissionBehavior.ALLOW, source="project"),
                ],
            },
        )
    ),
)
# 只有显式放行的命令会执行；其余调用（包括 `rm -rf /` 或写入
# ~/.bashrc 之类的安全 ASK）都被转为 DENY。无人值守的场景
# 推荐用 DONT_ASK 而不是 BYPASS：它保留了工具的安全网，同时
# 也从不打扰用户。

# BYPASS 按设计跳过工具的安全 ASK，拒绝规则因此成为唯一护栏。
# 使用 BYPASS 时，务必为想保护的路径与命令配上拒绝规则。
agent = Agent(
    name="my_agent",
    system_prompt="...",
    model=model,
    state=AgentState(
        permission_context=PermissionContext(
            mode=PermissionMode.BYPASS,
            deny_rules={
                "Bash": [
                    PermissionRule(tool_name="Bash", rule_content="rm:*",
                                   behavior=PermissionBehavior.DENY, source="userSettings"),
                    PermissionRule(tool_name="Bash", rule_content="git push:*",
                                   behavior=PermissionBehavior.DENY, source="userSettings"),
                ],
                "Write": [
                    PermissionRule(tool_name="Write", rule_content="**/.bashrc",
                                   behavior=PermissionBehavior.DENY, source="userSettings"),
                    PermissionRule(tool_name="Write", rule_content="**/.ssh/**",
                                   behavior=PermissionBehavior.DENY, source="userSettings"),
                ],
            },
        )
    ),
)
# 除拒绝列表中的命令与路径外其余均放行。
# 如果不配这些拒绝规则，BYPASS 会让智能体自由删除任意文件、
# 推送到任意远端、覆盖 ~/.bashrc，这是设计行为。