E.V.I.（嵌入式虚拟智能） - Theo API Docs

E.V.I. 是一个预配置的 Theo 客户端。只需创建一次，之后每次补全都会自动包含你的角色、技能和工具。

创建 E.V.I.

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" },
});

使用它

// 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. 的默认温度

// 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"],
});