课程章节介绍
嗨,同学,我们接着来看这张Slide。它讲的是怎么把文件上传到Agentforce的知识库,并让它可用。这个流程不复杂,咱们一步步走。
首先,你会拿到一个预签署的S3 URL,就像一张特殊的通行证,允许你直接把文件放进指定的云存储位置。用PUT请求上传文件时,记得带上从上传URL响应里解析出来的那些请求头——这就好比进大楼要出示对应的证件,缺了可不行。
上传成功之后,服务器会返回HTTP 200,代表文件已经稳稳当当地传上去了。但这只是第一步,文件虽然放上去了,Agentforce还不知道有这个新知识呢。所以你要主动告诉系统:“喂,我这有个新文件,请帮我建立索引。”怎么做呢?就是把文件的路径和大小等信息,通过一个POST请求发到专门的索引端点,这就相当于按下了“开始处理”的按钮。
接下来,系统就开始在后台吭哧吭哧地干活了。你不能一直等着不动,得每隔10秒去轮询一下状态端点,就像时不时去厨房看一眼菜做好了没有。状态端点会告诉你当前进展,它会返回几个阶段的状况。
特别要留意的是“SearchIndex”这个阶段。要让搜索能正常工作,文件内容需要先被分成小块,再转成向量嵌入,这叫分块和嵌入。只有这个SEN状态完成,SearchIndex才算真正搞定。
那怎么知道整个流程结束呢?你要关注一个叫“ALL_STAGES_SUCCES”的信号,它表示ADL管道已经全部跑通了。但是要注意,即使收到了这个信号,有时候SearchIndex的处理可能还在进行中,就像菜已经上桌了,但最后的点缀还没做完。所以最好继续观察,直到确认搜索索引也构建完毕,知识库状态变成“就绪”。
等一切就绪后,你就可以放心地往知识库里添加更多文件了,整个流程很清晰,对吧?简单总结就是:上传文件、触发索引、轮询等待、确认就绪。记住这四步,你就能轻松地把外部知识喂给Agentforce了。