访客接待
自动登记访客信息、实时通知被访人并引导访问流程，解决前台人工登记效率低、通知不及时、访客体验差的问题。
适用场景
1
写字楼大堂访客自助登记与身份核验
2
园区访客预约信息自动同步与门禁授权
3
前台无人值守时访客通过终端呼叫被访人
4
访客离开后自动签离并生成来访记录报表
核心Prompt（安装配置用）
角色设定：你是企业访客接待Agent，部署在前台终端或企业微信/钉钉入口，负责访客全流程接待。任务描述：1. 主动问候访客，询问并登记姓名、手机号、来访事由、被访人姓名及部门；2. 校验被访人是否存在于员工目录，若不存在则礼貌请访客确认或联系前台人工；3. 向被访人发送通知（企业IM或短信），包含访客姓名、事由、预计到达时间，并请求确认是否接待；4. 被访人确认后，生成临时通行凭证（二维码/验证码）并引导访客至指定区域；5. 访客离开时提醒签离，记录离开时间。输出格式：登记阶段输出JSON格式的访客信息；通知阶段输出通知文案与接收人；引导阶段输出通行凭证及路线指引文本。约束条件：不得泄露员工个人手机号等隐私信息；访客信息仅用于本次接待，存储不超过30天；若被访人5分钟内未确认，自动提醒前台人工介入；所有对话保持礼貌、简洁，单次交互不超过3轮。
所需工具 / API对接
企业微信/钉钉API（员工目录查询、消息通知）、短信网关API（备用通知）、门禁系统API（临时通行凭证下发）、访客管理系统API（登记与签离记录）、OCR身份证识别API（可选，快速录入）。
安装部署步骤
11. 环境准备：确认服务器或边缘终端已安装Docker 20.10+与docker-compose，开放443/8080端口，准备企业微信/钉钉管理员账号及API权限。
22. 安装依赖：执行 docker pull aiagent/visitor-reception:latest 拉取镜像，并执行 docker network create agent-net 创建网络。
33. 配置参数：复制 config.example.yaml 为 config.yaml，填入 corp_id、agent_id、secret、门禁API地址、通知模板ID等参数。
44. 导入Prompt：将 core_prompt 内容写入 config.yaml 的 prompt 字段，或通过管理后台“技能配置-访客接待”粘贴保存。
55. 连接工具API：在企业微信后台创建自建应用，获取CorpID与Secret；在门禁系统创建API Key并绑定临时通行权限模板；在短信网关配置签名与模板。
66. 测试验证：执行 docker-compose up -d 启动服务，访问 http://localhost:8080/health 返回ok；模拟访客“张三 138xxxx 拜访李四 技术部”，检查是否收到通知并生成凭证。
77. 上线部署：将终端切换至生产环境，配置HTTPS证书，设置每日凌晨自动备份访客数据，开启日志审计。
88. 灰度运行：先在一个前台试点运行3天，收集误报与漏报，调整通知超时时间与提示话术后全量推广。
配置参数
| 参数名 | 说明 | 默认值 |
|---|---|---|
notify_timeout |
被访人确认超时时间（秒），超时后转人工 | 300 |
data_retention_days |
访客数据保留天数 | 30 |
welcome_message |
访客终端首屏问候语 | 您好，欢迎光临，请告诉我您拜访的同事姓名 |
pass_type |
通行凭证类型：qrcode/code | qrcode |
fallback_phone |
人工前台电话，超时或异常时提示 | 内线8000 |
效果示例
访客在前台终端输入：“你好，我找技术部李四，我是张三，手机13800001111，来谈合作。”Agent回复：“张三您好，已为您登记。正在通知李四，请稍候。”系统向李四发送企业微信：“访客张三，事由：谈合作，预计到达时间：现在，是否接待？”李四点击“确认”。Agent生成二维码并显示：“李四已确认，请凭二维码至3楼技术部，闸机请扫码通行。”访客离开时，Agent提醒：“请扫码签离，感谢来访。”后台记录：姓名张三，被访人李四，进入时间14:05，离开时间14:50。
常见问题
问：被访人不在员工目录怎么办？答：Agent会提示访客确认姓名或部门，若仍无法匹配，自动转接前台人工电话，并记录待处理事项。
问：访客不会用终端或没有手机怎么办？答：支持前台人工代登记模式，Agent可切换为辅助模式，由前台人员输入信息后Agent完成通知与凭证生成。
问：通知被访人失败或超时如何处理？答：超过notify_timeout秒未确认，Agent自动向fallback_phone发送提醒，并提示访客稍等或联系前台。
问：访客数据安全如何保障？答：所有数据加密存储，仅保留data_retention_days天，访问需权限认证，支持审计日志导出。
问：能否对接现有门禁和访客系统？答：可以，通过标准REST API对接，若门禁系统不支持API，可使用二维码+人工核验的降级方案。
问：访客不会用终端或没有手机怎么办？答：支持前台人工代登记模式，Agent可切换为辅助模式，由前台人员输入信息后Agent完成通知与凭证生成。
问：通知被访人失败或超时如何处理？答：超过notify_timeout秒未确认，Agent自动向fallback_phone发送提醒，并提示访客稍等或联系前台。
问：访客数据安全如何保障？答：所有数据加密存储，仅保留data_retention_days天，访问需权限认证，支持审计日志导出。
问：能否对接现有门禁和访客系统？答：可以，通过标准REST API对接，若门禁系统不支持API，可使用二维码+人工核验的降级方案。
企业落地建议
建议采用边缘终端+云端管理混合部署，前台终端本地运行Agent保证断网可用，云端同步数据与配置。成本估算：软件订阅约5000-15000元/年（按终端数），硬件终端2000-4000元/台，API调用费按量计费。注意事项：先小范围试点，重点测试通知到达率与门禁联动稳定性；必须设置人工兜底流程，避免因系统故障导致访客滞留；定期更新员工目录，确保被访人信息准确。需要我们帮你落地吗？可以试试免费AI诊断→
需要我们帮你落地？
专业团队帮你从0到1部署企业AI Agent，含安装配置、定制开发、持续运营