pi-ask-user

介绍

pi-ask-user 是一个为 Pi 智能体框架设计的交互式工具包，它解决了智能体在自动化流程中遇到高影响、高模糊性决策时无法自主判断的问题。通过提供 ask_user 工具，智能体可以在运行时暂停，以清晰、美观的交互界面（如可搜索的选项列表、多选、自由输入等）向用户提问，并将用户的选择作为后续执行的依据。

使用时，开发者只需在智能体的代码中调用 ask_user 工具，传入问题、上下文和选项等参数。该工具会自动在终端中渲染出交互式界面（支持覆盖层或内联模式），用户可以使用键盘或鼠标进行选择，智能体则等待并接收用户反馈后继续执行。它支持在宽终端上显示分栏详情预览，在窄终端上自动回退到单列模式，并提供了临时隐藏界面以查看历史输出的快捷键。

该工具特别适合智能体开发者、项目经理以及任何需要将关键决策权交还给用户的自动化流程构建者。当智能体处理的任务涉及架构权衡、模糊需求或重大假设时，使用此工具可以避免因AI误判导致的严重后果，实现人机协同的“决策握手”。

建议在部署涉及业务逻辑、资金操作或内容发布的智能体时，集成此工具作为安全护栏。注意，虽然工具提供了超时自动关闭功能，但在关键决策场景下，建议不设置超时或设置较长的等待时间，以确保用户有充足时间做出审慎选择。