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

# E.V.I.（嵌入式虛擬智能）

> 創建預配置角色、技能和工具的品牌化 AI 助手。

E.V.I. 是一個預配置的 Theo 客戶端。只需創建一次，之後每次補全都會自動包含你的角色、技能和工具。

## 創建 E.V.I.

```typescript theme={null}
const evi = theo.evi({
  persona: "You are Nova, the AI assistant for WarehouseOS.",
  skills: ["data-extraction"],
  tools: [
    {
      name: "check_inventory",
      description: "Look up stock levels for a SKU",
      input_schema: {
        type: "object",
        properties: { sku: { type: "string" } },
        required: ["sku"],
      },
    },
  ],
  defaultMode: "auto",
  defaultTemperature: 0.7,
  metadata: { app: "warehouse-os" },
});
```

## 使用它

```typescript theme={null}
// Persona, skills, and tools are injected automatically
const res = await evi.complete({ prompt: "Check stock for SKU-A1234" });
const stream = evi.stream({ prompt: "Generate inventory report" });
```

## EviConfig

| 字段 | 類型 | 是否必需 | 說明 |
| - | - | - | - |
| `persona` | `string` | ✅ | 自定義系統提示詞——完全替代 Theo |
| `skills` | `string[]` | — | 每次補全都會啓用的技能 slug |
| `tools` | `ToolDef[]` | — | 每次補全都可使用的內聯工具 |
| `defaultMode` | `ChatMode` | — | 默認模式（默認值：`"auto"`） |
| `defaultTemperature` | `number` | — | 默認温度 |
| `metadata` | `Record<string, unknown>` | — | 附加在每個請求上的元數據 |

## 合併行為

每次請求傳入的值會與 E.V.I. 的默認值**合併**：

* `skills` —— E.V.I. 的技能 + 請求中的技能（合併後共同生效）
* `tools` —— E.V.I. 的工具 + 請求中的工具（合併後共同生效）
* `metadata` —— E.V.I. 的元數據與請求元數據合併（衝突時以請求為準）
* `mode` —— 請求中的模式會覆蓋 E.V.I. 的默認模式
* `temperature` —— 請求中的温度會覆蓋 E.V.I. 的默認温度

```typescript theme={null}
// E.V.I. has skills: ["data-extraction"]
// This request adds "compliance-checker" for a total of both
const res = await evi.complete({
  prompt: "Check compliance for order #123",
  skills: ["compliance-checker"],
});
```


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