> ## 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.