本技能用于在 Medusa 项目中添加仅供内部管理员使用的 AI 智能体，使用者是商家和店铺运营人员，而非门店前台顾客。面向顾客的智能体需要不同架构（公共 API 路由、不使用 MedusaExec、前台认证）。
主要能力与架构：智能体由 MedusaExec 驱动，可编写并执行 TypeScript 以访问数据库；数据模型 AgentSession 与 AgentMessage 为共享基础设施，通过 agent_type 区分不同智能体的会话，不按智能体分别建模型。模块位于 src/modules/agent/（service、models、agents、tools、config），API 路由位于 src/api/admin/agent/<agent-type>/，后台界面为 src/admin/routes/<agent-type>/page.tsx。流式输出采用 NDJSON，Content-Type 为 application/x-ndjson，每行一个 JSON 对象。
使用方式：所有智能体路由必须使用 AuthenticatedMedusaRequest 并置于 src/api/admin/ 下，认证不可省略；工具文件不得直接导入服务，需通过 experimental_context 传递 MedusaContainer；工具描述写在 config 对象中而非 tool() 内联；新增或修改模型后运行 npx medusa db:generate agent && npx medusa db:migrate，并在 medusa-config.ts 注册模块。实现前需按任务加载对应参考文件，如 data-models.md、service.md、agent-setup.md、api-route.md、streaming.md、admin-extension.md、medusa-exec.md。可配合 building-with-medusa 与 building-admin-dashboard-customizations 使用。测试可在后台输入只读提示并检查流式响应、会话与消息持久化，并通过网络面板与数据库表排查问题。
限制：仅适用于内部管理员场景，未授权的端点构成远程代码执行风险；除无法用可执行 TypeScript 表达的能力（如带密钥的外部 API 调用）外，不应构建自定义工具。官方资料未提供价格与平台信息。