emergent平台首个智能体创建指南:从注册实名认证、新建blank agent并配置system prompt,到web ui调试和curl api调用,最后接入微信公众号,每步标注界面位置与关键参数。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想在Emergent平台快速创建第一个智能体,却卡在注册后找不到入口、配置时看不懂提示词、调用API总返回错误?这篇指南从打开网页开始,每一步都标注真实界面位置和关键参数,不讲概念只教操作。
注册账号并完成实名认证
打开浏览器,访问 https://emergent.ai(注意不是 .com 或 .org),首页右上角点击【注册】按钮。
输入手机号→获取短信验证码→设置密码(需含大小写字母+数字,【密码强度不足会导致后续无法绑定支付方式】)→点击注册。
登录后立即跳转至实名认证页,系统强制拦截:未完成认证的账号无法创建Agent、无法调用任何API接口。上传身份证正反面照片→进行活体人脸识别→等待自动审核(通常60秒内完成)。
创建首个Agent实例
认证通过后,页面自动跳转至控制台首页。左侧导航栏找到【Agents】模块,点击进入。
点击【+ New Agent】按钮→在弹窗中选择模板类型为【Blank Agent】(不要选Quick Start,它会自动生成不可编辑的默认提示词)→输入Agent名称,例如“售后小助手”。
关键步骤:在【System Prompt】文本框中,必须写明角色定位与行为边界,例如:“你是一名专注处理订单退货问题的客服,仅回答‘能否退货’‘如何寄回’‘退款多久到账’三类问题,其余问题统一回复‘请拨打400热线咨询人工客服’”。【此处留空或写‘请友好回答用户问题’将导致Agent在测试中胡言乱语】
点击【Save & Publish】,页面顶部显示绿色提示“Published successfully”,同时生成一串以“agt_”开头的Agent ID——这是后续调用必需的唯一标识符。
本地验证Agent响应效果
方法一:使用控制台内置Web UI调试
回到Agents列表页,找到刚发布的Agent,点击右侧【Chat】按钮→在弹出窗口中直接输入:“我的订单号是EMG202608071234,衣服洗后严重褪色,能退货吗?”→点击发送。
观察回复内容是否严格限定在退货政策范围内,若出现“建议您试试这款新上架的防晒衣”之类无关推荐,说明System Prompt约束失效,需重新编辑并发布。
方法二:用curl命令行调用API
第一步:在【Settings → API Keys】中创建新密钥,复制生成的key值(格式类似sk-xxx-emergent-xxx)。
第二步:打开终端,执行以下命令(将{your_api_key}替换为实际密钥,{your_agent_id}替换为上步获取的agt_开头ID):
curl -X POST https://api.emergent.ai/v1/chat \
-H "Authorization: Bearer {your_api_key}" \
-H "Content-Type: application/json" \
-d '{ "agent_id": "{your_agent_id}", "messages": [{"role":"user","content":"订单EMG202608071234褪色能退吗?"}] }'
若返回JSON中包含"message":{"content":"根据平台规则,洗后褪色属于商品质量问题,支持全额退款...",说明调用成功;若返回401错误,检查密钥是否过期或复制时多出空格。
接入微信公众号作为服务入口
第一步:在微信公众号后台开通【开发者模式】,获取AppID与AppSecret。
第二步:回到Emergent控制台,进入【Integrations → WeChat Official Account】→点击【Connect】→粘贴AppID与AppSecret→点击【Verify】。
第三步:系统自动生成Webhook URL(形如https://webhook.emergent.ai/xxx),复制该链接→在微信公众号后台【基本配置】中填入服务器配置URL,并将Token与EncodingAESKey同步填写至Emergent平台对应字段。
第四步:启用开关,点击【Activate】。此时公众号任意对话将自动路由至你创建的Agent,无需编写一行转发逻辑代码。











