把 Design Pickle 的 API 轮询改成 Agent 编

<article>
<h2>如何将 API 轮询升级为 Agent 编排流程？</h2>
<p>在对接设计外包 API（如 Design Pickle）时，传统的 Python 脚本轮询状态并发送 Slack 通知只能解决信息同步问题，无法降低沟通成本。我尝试利用 MCP（Model Context Protocol）将流程重构为 Agent 编排，让 LLM 直接接管创意请求的生命周期，实现从意图识别到参数映射的自动化。</p>

<h2>如何���决 Agent 调用 API 时的参数幻觉问题？</h2>
<p>在实操中，直接向 Agent 开放 <code>create_design_request</code> 接口极易导致请求失败。由于该接口要求严格的 JSON 结构，Agent 经常会幻觉出不存在的 <code>request_type_id</code> 或在指令字符串中遗漏转义字符，导致 API 返回 400 错误。</p>
<p>我的解决方案是构建一个强制性的逻辑链条：<strong>禁止 Agent 直接创建请求，必须先执行查询</strong>。具体执行路径为：用户输入 → Agent 调用 <code>list_request_types</code> → 获取合法 ID 列表 → 映射参数 → 执行 <code>create_design_request</code>。</p>
<p>典型的请求映射 JSON 结构如下：</p>
<pre><code>{
"action": "create_design_request",
"params": {
"request_type_id": "logo_design_01",
"directions": "Summer campaign logo, high-res, follow brand_guide_v2",
"file_formats": ["PNG", "SVG"]
}
}</code></pre>

<h2>如何利用写回能力实现自动化分拣？</h2>
<p>单纯使用 <code>get_design_request_details</code> 读取状态是低效的。我将 Agent 定位为“生产协调员”，通过监控队列状态实现闭环管理。当 Agent 监测到请求进入“分拣（Triage）”状态时，触发以下自���化动作：</p>
<ol>
<li>自动调用 <code>list_brands</code> 检索当前项目的品牌规范。</li>
<li>对比初稿描述与品牌指南的配色、字体要求。</li>
<li>若检测到偏差，直接调用更新接口修改请求指令，而非仅发送通知。</li>
</ol>

<h2>如何保障 Agent 操作业务资产的安全性？</h2>
<p>赋予 Agent 修改权限（如取消请求、更新指令）存在极高风险。为了防止插件执行毁灭性操作或数据泄露，我在架构上采取了三层防护：</p>
<ul>
<li><strong>环境隔离：</strong> 在 Vinkius 中采用 V8 沙箱隔离执行环境，限制 Agent 只能访问定义好的工具集。</li>
<li><strong>数据管控：</strong> 部署 DLP（数据防泄漏）策略，过滤敏感品牌资产在传输过程中的明文暴露。</li>
<li><strong>审计追踪：</strong> 引入 HMAC 审计链，确保每一次 API 调用都有可追溯的签名，防止非法篡改请求参数。</li>
</ul>
</article>