> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitheo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 测试技能构建器

> 在沙盒模式下，通过已编译的技能构建器发送测试消息。

```http theme={null}
POST /api/v1/evi/canvases/{id}/test
Authorization: Bearer theo_sk_...
Content-Type: application/json

{
  "message": "Check stock for SKU-1234",
  "history": [
    { "role": "user", "content": "Hello" },
    { "role": "assistant", "content": "Hi! How can I help?" }
  ]
}
```

编译该技能构建器（或使用缓存的编译结果），并通过沙盒发送测试消息。工具调用会使用模拟数据进行仿真——不会发出任何真实的外部请求。

## 参数

* `message` (string, required) — 测试消息（最多 4000 个字符）。
* `history` (array, optional) — 用于多轮测试的最多 10 条历史消息。每条消息包含 `role`（"user" 或 "assistant"）和 `content`。

## 响应

```json theme={null}
{
  "response": "SKU-1234 currently has 47 units in stock...",
  "cost_cents": 5
}
```

## Sandbox Constraints

* 不会发出真实的外部 HTTP 请求
* 工具调用返回模拟数据
* 响应内容为便于测试而保持简洁
* 额度按标准费率扣除

如果该技能构建器编译失败，则返回 `422`。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.