Composio 集成 Figma 实战指南认证配置、工具发现与设计 Token 工作流【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composioFigma 是设计师与开发者协作的核心工具而通过 Composio 的 Figma toolkitAI Agent 可以直接读取设计文件、提取设计 Token、渲染节点、管理评论与 Webhook。本文基于 Composio 官方知识库文档 docs/kb/articles/toolkits-figma.md完整讲解 Figma 在生产环境下的认证配置、429 限流处理、废弃 scope 清理、跨认证模式工具发现以及设计 Token 与组件提取的最佳实践。读完本文你将能正确配置 Figma 连接、排查常见认证与限流问题并掌握FIGMA_EXTRACT_DESIGN_TOKENS等核心工具的正确用法。一、配置 Figma 生产环境认证让 Composio 处理 Bearer 授权对于 Figma 集成Composio 的设计原则是授权头Bearer authorization由 Composio 内部处理客户无需手工创建独立的 Bearer-token 认证方案。在常规 Figma 工具使用场景下你只需在 toolkit 的认证模式auth mode中提供受支持的凭据或 TokenComposio 会自动在每次 API 调用中注入 Bearer 授权头。这意味着无需在自定义认证配置中额外定义 Bearer-token scheme连接建立后所有 Figma 工具共享同一份凭据管理凭据轮换、刷新由连接生命周期统一管理。这一点同样记录在 docs/kb/source/toolkits/figma/public.md 与知识库渲染版 docs/content/kb/guide/toolkits-figma.mdx 中。两种受支持的认证模式从仓库的 toolkit 元数据docs/public/data/toolkits.json 中slug: figma条目可以看到Figma toolkit 声明了两种认证方案认证模式配置名称说明OAUTH2figma_oauth2默认由 Composio 托管的 OAuth 应用也支持使用客户自己的 OAuth 应用需提供client_id、client_secretAPI_KEYfigma_api_key个人访问令牌以figd_开头在 Figma 的 Settings → Security 中创建composioManagedAuthSchemes字段显示OAUTH2是 Composio 托管模式而API_KEY需要客户自行提供凭据。OAuth2 模式字段创建认证配置时需要client_id必填OAuth 应用的客户端 IDclient_secret必填OAuth 应用的客户端密钥full必填默认https://api.figma.comFigma API 基础地址仅在通过代理路由 Figma 流量时需要修改oauth_redirect_uri可选默认https://backend.composio.dev/api/v1/auth-apps/add需要加入 OAuth 应用的重定向白名单scopes可选以逗号分隔的权限列表默认值为file_comments:write,webhooks:write,current_user:read,file_content:read,file_comments:read,projects:read,library_assets:read,library_content:read,team_library_content:read,file_metadata:read,file_versions:read,webhooks:read。API_KEY 模式字段full必填默认https://api.figma.comAPI 基础地址generic_api_key必填Figma 个人访问令牌创建时需按需勾选 scope且只在创建瞬间显示一次务必立即保存。认证配置的增删改查由 Python SDK 的AuthConfigs客户端封装相关行为可参考 python/tests/test_auth_configs.py覆盖list、create、retrieve、update、delete、update_status等接口。二、生产环境下的 429 限流处理判断 429 的来源当 Figma 返回429状态码时说明请求被 Figma 侧限流。官方知识库的建议是先确认响应确实来自 Figma而非 Composio 或中间代理层查阅 Figma 官方的限流文档确认具体的限流窗口与配额降低请求频率、加入退避backoff逻辑在提供方限流重置后再重试。FAQ 文档 docs/content/toolkits/faq/figma.md 补充说明429 意味着 Figma 对该请求做了 rate limit应确认响应来源、减少请求量、添加 backoff并在提供方限额重置后重试。生产环境应使用客户自有凭据Composio 的默认 Figma 应用适用于快速测试但生产流量建议使用客户自己的 Figma 凭据理由包括避免共享应用的压力shared-app pressure多个客户共用默认应用时任何一方的突发流量都可能影响整体配额自主控制 scope 范围按业务需要申请最小权限自主控制流量模式与限流暴露面使用独立凭据后限流配额与你的真实流量一一对应便于容量规划。三、清理废弃 scopefile_read如果 Figma 认证配置中包含了已废弃的file_readscope需要从认证配置中移除该 scope重新发起一次新的连接initiate a new connection使新 scope 生效。废弃 scope 的残留可能影响工具调用或导致权限校验异常因此在变更 scope 后务必重建连接而不是复用旧连接。这一点在源文档 docs/kb/source/toolkits/figma/public.md 中同样有明确记录。四、跨认证模式发现并运行 Figma 工具Figma 工具应当与连接方式无关地正常工作无论连接使用的是Composio 托管的 OAuthmanaged OAuth自定义 OAuth 应用custom OAuth appToken / API-Key 认证。如果找不到某个工具官方建议的排查路径是动态拉取可用工具列表fetch available tools dynamically确认工具是否存在于当前 toolkit 版本中检查该工具所要求的认证 scope确认当前连接的凭据是否覆盖这些 scope。从 docs/public/data/toolkits.json 的 Figma 条目看当前版本20260721_00共包含53 个工具覆盖注释、Webhook、变量、组件、样式、库分析library analytics、图片渲染等能力工具缺失时也可通过 Composio 的工具请求入口提交需求。五、设计 Token 与组件工作流核心工具组合针对 Figma 设计 Token 与组件工作流官方推荐使用以下三个工具工具作用关键参数FIGMA_EXTRACT_DESIGN_TOKENS提取设计 Token样式 变量 节点值file_key、include_variablesFIGMA_DESIGN_TOKENS_TO_TAILWIND将设计 Token 转换为 Tailwind CSS 配置tokens前一步提取的 DesignTokens 对象FIGMA_GET_FILE_NODES按节点 ID 获取文件 JSON避免整文件载荷过大file_key、ids、depthFIGMA_EXTRACT_DESIGN_TOKENS的取值逻辑只捕获编码为 Figma 样式styles或变量variables的值未编码为样式/变量的设计值会被静默忽略完整的输出依赖file_variables:readscope 以及支持变量的 Figma 套餐。若变量提取为空可补充调用FIGMA_GET_LOCAL_VARIABLES。FIGMA_DESIGN_TOKENS_TO_TAILWIND是两步工作流先用FIGMA_EXTRACT_DESIGN_TOKENS配合file_key提取设计 Token再将返回的DesignTokens对象传给本工具的tokens参数。它会生成tailwind.config.ts/js含主题扩展并可选择生成带字体导入的globals.css。阴影颜色支持两种格式字符串形式如rgba(15, 110, 110, 0.32)或字典形式如{r: 0.059, g: 0.431, b: 0.431, a: 0.32}。FIGMA_GET_FILE_NODES用于在已知目标节点 ID 时按需获取节点 JSON规避整文件 JSON 的载荷上限快速发现阶段建议使用depth1。废弃工具FIGMA_GET_COMPONENT旧的FIGMA_GET_COMPONENT动作已标记为deprecated应改用FIGMA_GET_FILE_NODES获取组件数据。工具清单中标注为 Get component (Deprecated)说明文字明确写道DEPRECATED: Use FIGMA_GET_FILE_NODES instead.。此外获取已发布组件元数据时还可使用FIGMA_GET_COMPONENT2与FIGMA_GET_COMPONENT_SET。include_variables的套餐限制与 FAQ 细节FIGMA_EXTRACT_DESIGN_TOKENS在启用include_variables时可能失败原因是该工具会调用 Figma 的local variables 端点要求连接账户具备file_variables:readscope若 Figma 返回 403 并提示端点需要file_variables:read则需要用能够授予该 scope 的 Figma 凭据重新连接Figma 仅对 Enterprise 组织成员开放file_variables:readscope见 docs/content/toolkits/faq/figma.md。两个务实的处理路径确认套餐/API 访问权限检查当前 Figma 套餐是否支持变量相关 API降级绕过如果不需要 Figma 变量将include_variables设为false。此时工具仍可从本地样式local styles与节点中提取 Token只是不再调用 variables 端点。相关工具横向参考围绕设计资源同一 toolkit 中还提供了一系列与 Token/组件工作流配套的工具便于构建完整的设计 → 代码流水线资源发现FIGMA_DISCOVER_FIGMA_RESOURCES可从任意 Figma URL/file/、/design/、/board/、/proto/、/slides/解析出file_key并支持 team → projects → files → nodes 的发现流程文件读取FIGMA_GET_FILE_JSON自动简化CSS 风格属性名、去重变量、体积缩减 70%、FIGMA_GET_FILE_METADATA、FIGMA_GET_FILE_STYLES变量与样式FIGMA_GET_LOCAL_VARIABLES、FIGMA_GET_PUBLISHED_VARIABLES仅 Enterprise 组织正式成员可用、FIGMA_CREATE_MODIFY_DELETE_VARIABLES、FIGMA_GET_STYLE渲染与下载FIGMA_RENDER_IMAGES_OF_FILE_NODESPNG/JPG/SVG/PDF节点图 URL 有效期 30 天单图上限 32 兆像素、FIGMA_DOWNLOAD_FIGMA_IMAGES组件库FIGMA_GET_FILE_COMPONENTS、FIGMA_GET_COMPONENT_SET、FIGMA_GET_TEAM_COMPONENTS、FIGMA_GET_TEAM_STYLES。六、排查清单速查症状排查方向工具调用报 403提示需要file_variables:read确认 Figma 套餐该 scope 仅 Enterprise 成员可用或设置include_variablesfalse绕过返回 429确认响应来自 Figma降低请求量、加退避重试生产环境切换为客户自有凭据找不到某个 Figma 工具动态拉取工具列表检查工具所需 scope 是否在连接凭据中或通过工具请求入口提交认证配置含废弃file_readscope移除 scope 后重新发起新连接FIGMA_GET_COMPONENT不可用该工具已废弃改用FIGMA_GET_FILE_NODES总结Composio 的 Figma toolkit 将认证、限流与工具发现封装成了可复用的能力Composio 内部处理 Bearer 授权客户只需在认证模式中提供凭据生产环境建议使用自有 Figma 凭据以独立控制 scope 与限流配额设计 Token 工作流以FIGMA_EXTRACT_DESIGN_TOKENS→FIGMA_DESIGN_TOKENS_TO_TAILWIND为主线用FIGMA_GET_FILE_NODES按需取节点数据并注意include_variables依赖 Enterprise 级file_variables:readscope。掌握了这些要点你就能在 Agent 应用中稳定、安全地打通Figma 设计 → 代码 Token的自动化链路。【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Composio 集成 Figma 实战指南：认证配置、工具发现与设计 Token 工作流
Composio 集成 Figma 实战指南认证配置、工具发现与设计 Token 工作流【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composioFigma 是设计师与开发者协作的核心工具而通过 Composio 的 Figma toolkitAI Agent 可以直接读取设计文件、提取设计 Token、渲染节点、管理评论与 Webhook。本文基于 Composio 官方知识库文档 docs/kb/articles/toolkits-figma.md完整讲解 Figma 在生产环境下的认证配置、429 限流处理、废弃 scope 清理、跨认证模式工具发现以及设计 Token 与组件提取的最佳实践。读完本文你将能正确配置 Figma 连接、排查常见认证与限流问题并掌握FIGMA_EXTRACT_DESIGN_TOKENS等核心工具的正确用法。一、配置 Figma 生产环境认证让 Composio 处理 Bearer 授权对于 Figma 集成Composio 的设计原则是授权头Bearer authorization由 Composio 内部处理客户无需手工创建独立的 Bearer-token 认证方案。在常规 Figma 工具使用场景下你只需在 toolkit 的认证模式auth mode中提供受支持的凭据或 TokenComposio 会自动在每次 API 调用中注入 Bearer 授权头。这意味着无需在自定义认证配置中额外定义 Bearer-token scheme连接建立后所有 Figma 工具共享同一份凭据管理凭据轮换、刷新由连接生命周期统一管理。这一点同样记录在 docs/kb/source/toolkits/figma/public.md 与知识库渲染版 docs/content/kb/guide/toolkits-figma.mdx 中。两种受支持的认证模式从仓库的 toolkit 元数据docs/public/data/toolkits.json 中slug: figma条目可以看到Figma toolkit 声明了两种认证方案认证模式配置名称说明OAUTH2figma_oauth2默认由 Composio 托管的 OAuth 应用也支持使用客户自己的 OAuth 应用需提供client_id、client_secretAPI_KEYfigma_api_key个人访问令牌以figd_开头在 Figma 的 Settings → Security 中创建composioManagedAuthSchemes字段显示OAUTH2是 Composio 托管模式而API_KEY需要客户自行提供凭据。OAuth2 模式字段创建认证配置时需要client_id必填OAuth 应用的客户端 IDclient_secret必填OAuth 应用的客户端密钥full必填默认https://api.figma.comFigma API 基础地址仅在通过代理路由 Figma 流量时需要修改oauth_redirect_uri可选默认https://backend.composio.dev/api/v1/auth-apps/add需要加入 OAuth 应用的重定向白名单scopes可选以逗号分隔的权限列表默认值为file_comments:write,webhooks:write,current_user:read,file_content:read,file_comments:read,projects:read,library_assets:read,library_content:read,team_library_content:read,file_metadata:read,file_versions:read,webhooks:read。API_KEY 模式字段full必填默认https://api.figma.comAPI 基础地址generic_api_key必填Figma 个人访问令牌创建时需按需勾选 scope且只在创建瞬间显示一次务必立即保存。认证配置的增删改查由 Python SDK 的AuthConfigs客户端封装相关行为可参考 python/tests/test_auth_configs.py覆盖list、create、retrieve、update、delete、update_status等接口。二、生产环境下的 429 限流处理判断 429 的来源当 Figma 返回429状态码时说明请求被 Figma 侧限流。官方知识库的建议是先确认响应确实来自 Figma而非 Composio 或中间代理层查阅 Figma 官方的限流文档确认具体的限流窗口与配额降低请求频率、加入退避backoff逻辑在提供方限流重置后再重试。FAQ 文档 docs/content/toolkits/faq/figma.md 补充说明429 意味着 Figma 对该请求做了 rate limit应确认响应来源、减少请求量、添加 backoff并在提供方限额重置后重试。生产环境应使用客户自有凭据Composio 的默认 Figma 应用适用于快速测试但生产流量建议使用客户自己的 Figma 凭据理由包括避免共享应用的压力shared-app pressure多个客户共用默认应用时任何一方的突发流量都可能影响整体配额自主控制 scope 范围按业务需要申请最小权限自主控制流量模式与限流暴露面使用独立凭据后限流配额与你的真实流量一一对应便于容量规划。三、清理废弃 scopefile_read如果 Figma 认证配置中包含了已废弃的file_readscope需要从认证配置中移除该 scope重新发起一次新的连接initiate a new connection使新 scope 生效。废弃 scope 的残留可能影响工具调用或导致权限校验异常因此在变更 scope 后务必重建连接而不是复用旧连接。这一点在源文档 docs/kb/source/toolkits/figma/public.md 中同样有明确记录。四、跨认证模式发现并运行 Figma 工具Figma 工具应当与连接方式无关地正常工作无论连接使用的是Composio 托管的 OAuthmanaged OAuth自定义 OAuth 应用custom OAuth appToken / API-Key 认证。如果找不到某个工具官方建议的排查路径是动态拉取可用工具列表fetch available tools dynamically确认工具是否存在于当前 toolkit 版本中检查该工具所要求的认证 scope确认当前连接的凭据是否覆盖这些 scope。从 docs/public/data/toolkits.json 的 Figma 条目看当前版本20260721_00共包含53 个工具覆盖注释、Webhook、变量、组件、样式、库分析library analytics、图片渲染等能力工具缺失时也可通过 Composio 的工具请求入口提交需求。五、设计 Token 与组件工作流核心工具组合针对 Figma 设计 Token 与组件工作流官方推荐使用以下三个工具工具作用关键参数FIGMA_EXTRACT_DESIGN_TOKENS提取设计 Token样式 变量 节点值file_key、include_variablesFIGMA_DESIGN_TOKENS_TO_TAILWIND将设计 Token 转换为 Tailwind CSS 配置tokens前一步提取的 DesignTokens 对象FIGMA_GET_FILE_NODES按节点 ID 获取文件 JSON避免整文件载荷过大file_key、ids、depthFIGMA_EXTRACT_DESIGN_TOKENS的取值逻辑只捕获编码为 Figma 样式styles或变量variables的值未编码为样式/变量的设计值会被静默忽略完整的输出依赖file_variables:readscope 以及支持变量的 Figma 套餐。若变量提取为空可补充调用FIGMA_GET_LOCAL_VARIABLES。FIGMA_DESIGN_TOKENS_TO_TAILWIND是两步工作流先用FIGMA_EXTRACT_DESIGN_TOKENS配合file_key提取设计 Token再将返回的DesignTokens对象传给本工具的tokens参数。它会生成tailwind.config.ts/js含主题扩展并可选择生成带字体导入的globals.css。阴影颜色支持两种格式字符串形式如rgba(15, 110, 110, 0.32)或字典形式如{r: 0.059, g: 0.431, b: 0.431, a: 0.32}。FIGMA_GET_FILE_NODES用于在已知目标节点 ID 时按需获取节点 JSON规避整文件 JSON 的载荷上限快速发现阶段建议使用depth1。废弃工具FIGMA_GET_COMPONENT旧的FIGMA_GET_COMPONENT动作已标记为deprecated应改用FIGMA_GET_FILE_NODES获取组件数据。工具清单中标注为 Get component (Deprecated)说明文字明确写道DEPRECATED: Use FIGMA_GET_FILE_NODES instead.。此外获取已发布组件元数据时还可使用FIGMA_GET_COMPONENT2与FIGMA_GET_COMPONENT_SET。include_variables的套餐限制与 FAQ 细节FIGMA_EXTRACT_DESIGN_TOKENS在启用include_variables时可能失败原因是该工具会调用 Figma 的local variables 端点要求连接账户具备file_variables:readscope若 Figma 返回 403 并提示端点需要file_variables:read则需要用能够授予该 scope 的 Figma 凭据重新连接Figma 仅对 Enterprise 组织成员开放file_variables:readscope见 docs/content/toolkits/faq/figma.md。两个务实的处理路径确认套餐/API 访问权限检查当前 Figma 套餐是否支持变量相关 API降级绕过如果不需要 Figma 变量将include_variables设为false。此时工具仍可从本地样式local styles与节点中提取 Token只是不再调用 variables 端点。相关工具横向参考围绕设计资源同一 toolkit 中还提供了一系列与 Token/组件工作流配套的工具便于构建完整的设计 → 代码流水线资源发现FIGMA_DISCOVER_FIGMA_RESOURCES可从任意 Figma URL/file/、/design/、/board/、/proto/、/slides/解析出file_key并支持 team → projects → files → nodes 的发现流程文件读取FIGMA_GET_FILE_JSON自动简化CSS 风格属性名、去重变量、体积缩减 70%、FIGMA_GET_FILE_METADATA、FIGMA_GET_FILE_STYLES变量与样式FIGMA_GET_LOCAL_VARIABLES、FIGMA_GET_PUBLISHED_VARIABLES仅 Enterprise 组织正式成员可用、FIGMA_CREATE_MODIFY_DELETE_VARIABLES、FIGMA_GET_STYLE渲染与下载FIGMA_RENDER_IMAGES_OF_FILE_NODESPNG/JPG/SVG/PDF节点图 URL 有效期 30 天单图上限 32 兆像素、FIGMA_DOWNLOAD_FIGMA_IMAGES组件库FIGMA_GET_FILE_COMPONENTS、FIGMA_GET_COMPONENT_SET、FIGMA_GET_TEAM_COMPONENTS、FIGMA_GET_TEAM_STYLES。六、排查清单速查症状排查方向工具调用报 403提示需要file_variables:read确认 Figma 套餐该 scope 仅 Enterprise 成员可用或设置include_variablesfalse绕过返回 429确认响应来自 Figma降低请求量、加退避重试生产环境切换为客户自有凭据找不到某个 Figma 工具动态拉取工具列表检查工具所需 scope 是否在连接凭据中或通过工具请求入口提交认证配置含废弃file_readscope移除 scope 后重新发起新连接FIGMA_GET_COMPONENT不可用该工具已废弃改用FIGMA_GET_FILE_NODES总结Composio 的 Figma toolkit 将认证、限流与工具发现封装成了可复用的能力Composio 内部处理 Bearer 授权客户只需在认证模式中提供凭据生产环境建议使用自有 Figma 凭据以独立控制 scope 与限流配额设计 Token 工作流以FIGMA_EXTRACT_DESIGN_TOKENS→FIGMA_DESIGN_TOKENS_TO_TAILWIND为主线用FIGMA_GET_FILE_NODES按需取节点数据并注意include_variables依赖 Enterprise 级file_variables:readscope。掌握了这些要点你就能在 Agent 应用中稳定、安全地打通Figma 设计 → 代码 Token的自动化链路。【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考