HK//HACKERSHACKATHONS · KAGGLE · FOR BEGINNERSEN
HACKERS / 黑客松

Qloo Agentic Hackathon 新手攻略

Qloo 的线上黑客松,现金奖 25,000 美元(15,000、6,000 和 4,000 美元),要求做一个能运行的 Agent、Agent 工具,或者给已有的 Agent 接上 Qloo 的品味 API,让它更好地判断人们喜欢什么。提交截止时间是 2026 年 10 月 30 日 23:45(美东夏令时)。对新手来说最重要的有三点。第一,API Key 是填表后人工发放的,讨论区显示要等好几天,所以今天就去申请,不用等想好点子。第二,今年不要求视频,但必须有对外公开托管的在线演示、公开代码仓库和可见的开源许可证。第三,Qloo 在 2025 年 7 月办过一场同样奖金的比赛,我们读了全部 344 个作品:三分之一是面向普通消费者的旅行、美食、音乐、影视或时尚推荐器,没有一个获奖。四个获奖作品里有三个是给专业用户做的工具(选址市场分析、并购尽职调查、政治竞选文案),第四个则把推荐反过来做。

这场比赛已经结束,攻略保留作参考。下一届的规则、评审和日期可能会变,请先看官方页面。

截止已截止
奖金—
官方页面 ↗

头脑风暴词云

公开页面上的文字还太少,暂时提取不出关键词。赛题或作品集内容多起来后,词云会自动出现。

关键信息

主办方和评委
赞助方和运营方:Qloo(纽约),在 Devpost 上举办。概览页列出的评委有 Jason Calacanis、Mike Diolosa(Qloo CTO)、Nicole Seligman、Todd Boehly、Cedric the Entertainer 和 Michael Abrams。官方规则另外写明,评审可能采用专家组、同行评议、AI 自动分析或它们的组合 ↗
截止时间和日程
报名和提交:2026 年 9 月 30 日至 10 月 30 日 23:45(美东时间)(规则写的开放时间是 9:00,Devpost 日程写的是 9:30)。评审:2026 年 11 月 2–16 日。大约在 2026 年 11 月 23 日 15:00(美东时间)公布结果 ↗
谁能参加
在所在地达到法定成年年龄的个人、由他们组成的团队以及机构。不能参加的:美国法律或当地法律禁止的地区(规则点名了巴西、魁北克、俄罗斯、克里米亚、古巴、伊朗和朝鲜,以及其他受 OFAC 全面制裁的国家)、Qloo 和 Devpost 的员工及家属、评委以及评委任职的机构,还有由 Qloo 或 Devpost 资助或授权的项目 ↗
要做什么
一个接入 Qloo API 的可运行应用,并且满足以下任意一条:本身是 Agent 工具、用 Agent 框架构建,或者把 Qloo 接进你已有的 Agent。概览页给的检验方法是:如果去掉 Qloo 你的作品照样能用,那你做错了方向。旧项目只有在 Qloo 集成是提交期开始后才加上的情况下才允许参加,并且要说明改了什么 ↗
需要提交什么
1)一个任何人都能从头试到尾的在线演示链接,托管并公开在外部(网站、网页应用、托管的 APK 或 TestFlight 版本都可以;只能在本地运行或需要私人权限的项目不符合要求);2)公开的 GitHub、GitLab 或 Bitbucket 仓库,包含全部代码和运行说明;3)文字说明,讲清楚 Agent 做什么、Qloo 在其中起什么作用;4)开源许可证文件,要能显示在仓库的 About 栏里。不要求演示视频 ↗
视频的坑
概览页说不需要视频,但官方规则写明评委不一定会测试项目,可能只看文字说明、图片和视频来评分。录一段短视频、准备几张清楚的截图,成本很低,万一评委不打开你的演示也有保障 ↗
奖金
官方规则:一等奖 15,000 美元,二等奖 6,000 美元,三等奖 4,000 美元,所有合格作品都可以参评,每个项目只能拿一个奖。概览页还宣布了一项额外奖励:Jason Calacanis 会个人再投资 25,000 美元给他最喜欢的作品。这笔投资不在官方规则的奖金表里,在主办方公布条款之前,把它当作条件未知 ↗
评审流程
第一轮只看是否合格:作品是否符合主题,是否合理地用到了 Qloo API。第二轮按四项权重相同的标准打分:技术实现、设计、潜在影响和想法质量。同分时先比第一项,再比下一项,最后由评委投票 ↗
申请 API Key
填写开发者指南里链接的 Google 表单。Key 是人工发放的,通常几个工作日内通过邮件发出;Qloo 说邮件经常进垃圾箱。没想好点子也可以先申请。如果一直没收到、垃圾箱里也没有,就再提交一次表单 ↗
等 Key 的情况(来自讨论区)
在 Devpost 讨论区(10 月 18 日查看)上,有参赛者说提交表单后等了好几天,还有人说项目做到一半因为没有 Key 卡住了。Qloo 工作人员回复说,申请量非常大,Key 是分批发放的;在一个帖子里,他们还确认了有人的 Key 其实已经发到邮箱,只是本人没注意到。10 月 17–18 日仍然不断有人发“没收到”的帖子 ↗
接口地址的坑
黑客松发的 Key 只能用于 https://hackathon.api.qloo.com。同一个 Key 访问 staging.api.qloo.com 和 api.qloo.com 会返回 401,而大多数文档示例用的是后两个地址。Key 要放在 X-Api-Key 请求头里(不是 Bearer token),调用 /v2/insights 要用 GET 加查询参数,不要用 POST 请求体 ↗
悄无声息的空结果
每次调用 Insights 都需要 filter.type,可选值有:artist、book、brand、destination、movie、person、place、podcast、tv_show、video_game(urn:entity:...)。对该类型无效的参数会被悄悄忽略,所以返回 200 却没有任何实体,通常是参数写错了,而不是没有数据。标签和受众要用 /v2/tags 和受众接口返回的真实 ID;/recs 和 /recommendations 是旧接口,已不再支持 ↗
数据和缓存规则
不需要自备数据集。可以在服务器端私下缓存 Qloo 的返回结果,没有时间限制,但不要把 Qloo 返回的数据提交到公开仓库。调用额度可以在 Qloo 黑客松 Discord 的 #api-help 频道按人申请提高。比赛结束后 Key 会被停用,所以实时调用 Qloo 的演示之后就会失效 ↗
去年的比赛(本站整理)
Qloo LLM Hackathon(2025 年 7 月 1 日至 8 月 1 日):奖金同样是 25,000 美元,当时分成一个 10,000 美元大奖加三个 5,000 美元荣誉提名。今年六位评委里有五位去年也是评委。作品集共 344 个项目,我们在 2026 年 10 月 18 日解析了其中 343 个页面。获奖的有四个:GeoTaste(大奖)、Alloy、Resonance AI 和 Zesty。因为提交量大,获奖公布从 2025 年 8 月 19 日推迟到了 8 月 25 日 ↗
2025 年获奖作品做了什么(本站整理)
GeoTaste:给商家用的选址市场分析 Agent(React、Flask、Mapbox、GPT)。Alloy:给并购交易做文化尽职调查打分,基于 Gemini 2.5 Pro 的 ReAct Agent,通过 Qloo 的 /search 查找品牌对应实体,Qloo 查不到时退回网页搜索。Resonance AI:政治竞选文案工具,基于 Google 的 Agent Development Kit、Gemini 以及 Qloo 的人群画像和热力图。Zesty:一个“反推荐引擎”,专门推荐和你口味相反的东西(Next.js、Supabase、Gemini) ↗
规律一:产品服务谁(本站整理)
按标题和简介里的用词,343 个作品中有 112 个(33%)是面向普通消费者的旅行、美食、音乐、影视书籍或时尚推荐器,没有一个获奖。有 44 个(13%)点明了商家、营销、品牌、竞选或投资人用户;四个获奖作品里有三个属于这一类 ↗
规律二:交付得完整(本站整理)
四个获奖作品都有在线演示链接和嵌入视频;所有作品中 69% 有演示链接,78% 有视频,78% 有仓库链接,而两者都有的只有 56%——今年这两样都是必须的。获奖作品的说明在 500 到 1,013 词之间(中位数约 835),全部作品的中位数是 490 ↗
规律三:工具和队伍人数(本站整理)
39% 的作品提到了 Gemini,4 个获奖作品里有 3 个;34% 提到了 OpenAI/GPT,获奖作品里有 1 个。77% 的作品是单人完成的;获奖者是两个单人和两组两人队伍。常见的演示托管平台:Vercel(61 个作品)、Netlify(39)、Render(23)、Streamlit(15)。2026 年 10 月 18 日,2025 年四个获奖作品的演示网址有两个已经返回 404,所以要做好准备:API Key 和免费托管到期后,托管的演示就会失效 ↗
和 2025 年相比有什么变化
2025 年要求三分钟以内的演示视频,按五项标准打分,其中一项是“智能、用心地使用 LLM”。2026 年取消了视频要求,要求做 Agent 而不是 LLM 应用,新增了设计这一项(完整、连贯的产品,而不是概念验证),并且新增了开源许可证和外部托管的要求 ↗
参与规模(10 月 18 日查看)
2026 年 10 月 18 日 Devpost 显示有 1,725 名参与者,2025 年整场比赛是 2,847 人。今年的作品集还没公开,所以提交数量未知 ↗

选题方向

这些是我们给还剩大约十二天的新手的范围建议,依据是比赛规则和我们读过的 2025 年作品集。不是官方赛道。

为一种专业工作做一个品味 Agent

选一个替别人做决定的人:给新街区开店、要定菜单的咖啡馆老板,挑选演出阵容的场地订票人,给小品牌挑网红的营销人员。用 /search 把他们输入的内容对应到 Qloo 实体,用带地点或受众过滤的 Insights 给各个选项打分,再让 LLM 解释取舍。2025 年四个获奖作品里有三个走的是这条路,而整个参赛队伍里只有 13% 这样做。

把 Qloo 接进大家已经在用的 Agent

规则允许把 Qloo 接进已有的 Agent,只要集成是新加的。把两三个 Qloo 调用(search、insights、tags)作为工具放进一个 MCP 服务器或 Agent 框架,然后展示一个任务:没有 Qloo 时 Agent 做错了,有了 Qloo 就做对了。这种前后对比能让评委一眼看到技术实现和想法质量。

把推荐反过来

Zesty 在 2025 年靠推荐和你口味相反的东西拿了奖。同样的数据还能这样玩:检查晚宴或婚礼歌单里“客人会讨厌什么”,或者做一个送礼 Agent,避开对方已经有的东西。只做一条流程并打磨好,因为现在设计占了总分的四分之一。

比较两个地方或两类人群

带地点和人群信号的 Insights 能显示两座城市或两个年龄段之间的口味差异。做一个搬家、开店选址或巡演路线 Agent,把两个选项并排比较,一分钟内就能演示清楚;而且 2025 年的获奖作品里地图很常见(GeoTaste、Resonance AI 的热力图)。

评审标准

第一轮检查是否符合主题、是否真正用到了 Qloo API,只分合格与不合格。第二轮四项标准权重相同。技术实现排在第一,所以也用来决定同分名次。设计是今年新加的:要求一个能从头跑通的产品,而不是只演示一次 API 调用。 来源 ↗

技术实现(Technological Implementation)25%

对 Qloo 用得有多深入、多熟练,代码是否体现了真正的投入,是否是一个能运行、有一定复杂度的实现。同分时第一个比较这一项。

设计(Design)25%

完整、连贯的产品体验,而不只是技术上的概念验证。

潜在影响(Potential Impact)25%

可信、具体地说明为一群真实用户解决一个真实问题,并且演示出来的内容确实解决了它。

想法质量(Quality of the Idea)25%

对 Qloo 有创意、不落俗套的用法,以及对问题领域的真正理解。

入门技术栈

  • 黑客松开发者指南 API Key 申请表、黑客松专用接口地址、支持的实体类型和常见错误 ↗
  • Insights API 详解 主要接口 /v2/insights,用于推荐和品味洞察 ↗
  • 各实体类型的参数 每种 filter.type 接受哪些信号和过滤条件;在怀疑是没数据导致空结果之前,先来这里核对 ↗
  • 实体搜索 把名称(电影、歌手、餐厅)转换成 Qloo 实体 ID,用作信号 ↗
  • 标签搜索 查找类型、菜系和兴趣的有效标签 ID;没有固定的标签列表 ↗
  • 热力图用例 基于地点的品味地图完整示例 ↗
  • Devpost 提交帮助 怎么创建项目页并在截止前提交 ↗

时间线

  1. 开放报名和提交(按官方规则;Devpost 日程写的是 9:30)
  2. 提交截止(美东夏令时 23:45)
  3. 开始评审;评审结束前保持演示在线、可免费使用
  4. 评审结束
  5. 大约在这个时间公布获奖名单(2025 年推迟了六天)

新手怎么做完

  1. 第 0 天:报名并申请 Key

    在 Devpost 点 Join,然后提交开发者指南里的 API Key 申请表,点子写个大概或者不写都行。每天检查垃圾邮件。如果过了好几个工作日还没收到,就再提交一次表单,并到黑客松 Discord 的 #api-help 发帖。

  2. 等 Key 的时候先写好一个调用

    按 https://hackathon.api.qloo.com、X-Api-Key 请求头、GET /v2/insights 写好请求代码,这样 Key 一到,第一次调用就能成功。filter.type 从支持的列表里选。

  3. 写一个“去掉 Qloo”的对照测试

    做界面之前,先把你的 Agent 要回答的问题直接问一遍裸的 LLM,保存它的回答。你的演示和说明要展示 Qloo 在哪里改变了答案。这正是概览页自己给的检验方法。

  4. 做完一条端到端流程

    输入、Agent 推理、Qloo 调用、结果页。设计是按完整的产品体验来打分的,所以一条窄但完整的流程,胜过一个很宽却做了一半的产品。

  5. 尽早公开部署

    在第 5 或第 6 天之前部署到任意公开托管平台(2025 年的作品大多用 Vercel、Netlify、Render 或 Streamlit)。Qloo Key 放在服务器端,并且在 11 月 16 日评审结束前保持演示可以免费使用。只能本地运行的项目不符合要求。

  6. 让仓库符合检查清单

    公开仓库,有 GitHub 能在 About 里显示的开源 LICENSE 文件,README 里写好运行步骤,并且不提交 Qloo 的返回数据(在服务器端私下缓存没问题)。

  7. 写给一个不会点开演示的评委看

    评委可能只根据说明、图片和视频打分。写大约 800–1,000 词(2025 年获奖作品的范围),讲清楚给谁用、调用了哪些 Qloo 接口以及为什么,还有前后对比。加上截图,可以再附一段短视频。

  8. 早点提交一份草稿

    Devpost 允许在截止前保存草稿;10 月 30 日 23:45(美东夏令时)之后就不能再修改提交了。