从Dialogflow Playbook调用Google Cloud Function时出现401错误排查

权限配置问题 #

• 未给调用Playbook的服务账号分配Cloud Functions Invoker（roles/cloudfunctions.invoker）角色，导致无权限触发该Cloud Function。
• Cloud Function的访问权限设置为“需要身份验证”，但调用方不在允许的访问列表中。

请求凭证问题 #

• Playbook调用${TOOL:user lookup}工具时，未携带有效的身份凭证（如服务账号JWT令牌、OAuth2访问令牌）。
• 使用的凭证已过期、被吊销，或者权限范围不足以访问目标Cloud Function。

OpenAPI规范缺失认证配置 #

• 提供的OpenAPI定义中未添加身份验证相关的securitySchemes和security字段，导致工具调用时未自动注入认证信息。

部署配置错误 #

• Cloud Function部署时，误将访问范围设置为“仅限内部访问”或特定成员，而调用方不在该范围内。
• OpenAPI中的服务器URL未正确替换<project_name>为实际项目ID，不过这种情况通常返回404，但部分场景下权限校验前置也可能触发401。

内容的提问来源于stack exchange，提问作者aaron blythe