@ agentapprove/ pi (英语)
代理核准 扩展名 Pi批准或拒绝 Pi 工具从您的 iPhone 或 Apple Watch 调用 。 把应用程序拿上 应用程序存储。 。 。 .
安装
运行代理批准安装器并选择 Pi :
npx agentapprove
如果代理批准已经在此机器上对齐, 您可以直接安装 Pi 包 :
pi install npm:@agentapprove/[email protected]
包含什么
tool_call屏蔽核准- 本地工具补全事件
- MCP 工具批准和完成事件由 MCP 服务器分组
- 迅速、反应、思考、压缩、停止和会话结束活动
- 代理代理的可选后续输入
运行时间映射
| Pi 活动 | 代理批准事件 |
|---|---|
session_start | session_start |
before_agent_start | user_prompt |
tool_call | 屏蔽批准请求 |
tool_result | command_executed, (中文(简体) ), tool_complete,或 mcp_complete |
tool_execution_end | 如果 tool_result 未观察到 |
message_end | thought, (中文(简体) ), response,或 plan_generated |
session_compact | context_compact |
agent_end | stop,带有可选后续输入 |
session_shutdown | session_end |
核准请求包括:
{
agent: "pi",
hookType: "tool_call",
toolName: string,
toolType: string,
toolInput?: object,
command?: string,
conversationId: string,
generationId?: string,
toolCallId?: string,
model?: string,
mcpServer?: RuntimeMcpServer,
metadata: {
sessionId: string,
piEventName: "tool_call",
cwd?: string,
workspaceRoots?: string[],
turnId?: string,
messageId?: string,
provider?: string,
model?: string,
toolCallId?: string
},
timestamp: number
}
事件使用相同的代理批准事件信封 agent: "pi", (中文(简体) ), eventType, (中文(简体) ), conversationId选项 generationId,可选工具元数据,可选 mcpServer选项 sessionStats, (中文(简体) ), metadata,以及 timestamp。 。 。 .
配置
扩展读取标准代理批准配置 ~/.agentapprove/env。 。 。 .
| 变量 | 默认 | 说明 |
|---|---|---|
AGENTAPPROVE_API | https://api.agentapprove.com | 代理批准 API URL |
AGENTAPPROVE_API_VERSION | v001 | API 版本 |
AGENTAPPROVE_TOKEN | 密钥链或配置令牌 | CLI API 符号 |
AGENTAPPROVE_PRIVACY | full | minimal, (中文(简体) ), summary,或 full |
AGENTAPPROVE_FAIL_BEHAVIOR | ask | allow, (中文(简体) ), deny,或 ask 如果代理批准无法到达 |
AGENTAPPROVE_AGENT_NAME | Pi | 显示此 Pi 代理的名称 |
AGENTAPPROVE_PI_NAME | Pi | 遗留 Pi 特定显示名倒置 |
警卫
请求与代理批准HMAC信头签署,并包括已安装包捆的SHA256散列. API允许列表通过钩子版本发布了捆绑散列.