开启新session必须先选择已部署且状态为“live”的agent,再绑定唯一session_id并初始化上下文。支持直接点击、关键词搜索、id精确匹配三种选agent方式,未部署或非live状态agent不显示。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Agent Space中开启新Session时,必须明确指定由哪个Agent承接本次会话,否则系统将无法路由消息、加载对应上下文,甚至直接报错“no agent bound to session”。
创建Session前必须先选好Agent
进入目标Workspace后,点击左侧菜单「Sessions」→「+ New Session」,此时页面不会立即创建会话,而是强制弹出Agent选择面板。
该面板只列出当前Workspace中已部署且状态为“live”的Agent;处于“draft”“failed”或“unauthorized”状态的Agent会被自动过滤,不显示。
【未部署的Agent不会出现在列表中,哪怕它已保存在Agents页】。
三种Agent选择方式及适用场景
方法一:从已部署列表中直接点击选择(最常用)
在弹出面板中,逐个查看Agent名称、角色描述和最后部署时间,点击你确认已配置完成、权限已授、数据源已挂载的那个Agent。例如:“合同查询员”——确认其已绑定contract-archive-bucket读权限,且Data Sources页显示PDF解析器就绪。
方法二:通过搜索快速定位
当Workspace内Agent超过5个时,面板顶部会出现搜索框。输入关键词如“审批”“法务”“HR”,系统仅匹配Agent的name和role字段,不搜description或YAML注释。
方法三:用ID精确匹配(适合CI/CD自动化场景)
若已知Agent唯一ID(形如ag_8f3c2d9a),可在搜索框前加前缀id:,例如输入id:ag_8f3c2d9a,面板将跳过模糊匹配,直取该ID对应Agent。此方式绕过名称重复风险,但ID需从API响应或部署日志中获取,控制台界面不展示。
选择后必须绑定session_id并初始化
第一步:点击选定Agent后,页面自动跳转至Session配置页。
第二步:手动填写或自动生成session_id——【必须确保该session_id全局唯一,不可复用已有会话ID,否则上下文将被覆盖】。
第三步:勾选“Auto-load project context”,让系统自动注入AGENTS.md与Codex-style全局上下文。
第四步:点击「Start Session」,页面顶部出现蓝色横幅:“Session active — bound to contract-reader (ag_8f3c2d9a)”。











