概览快速开始

快速入门指南

以 Markdown 格式查看

先注册您的 Alephant 工作区，在仪表盘中创建智能体身份和成本控制对象，然后在终端或应用中使用生成的虚拟密钥，即可开始使用 Alephant。

1. 注册 Alephant

打开 Alephant 仪表盘，创建账户或登录您的工作区。

注册 Alephant

无需信用卡即可从 Free 套餐开始。注册后，请继续执行以下工作区设置步骤。

2. 创建部门

在企业工作区中，请先创建部门。部门将成员、智能体、预算和用量归因归入同一个业务单元。

创建新部门

设置描述性部门名称、月度预算和超出预算时的行为。这会为该部门下创建的每个智能体提供明确的成本中心。

3. 添加 API Key

将您的上游提供商密钥添加为主密钥。Alephant 会安全地存储该提供商凭据，并且仅在为您的智能体路由请求时使用它。

添加提供商 API 密钥

选择您的提供商，进入密钥配置步骤，然后保存提供商密钥。您可以添加 OpenAI、Anthropic、Gemini、OpenRouter、DeepSeek、AWS Bedrock、Azure OpenAI 或自定义 OpenAI 兼容端点的密钥。

4. 创建智能体

为将发送 AI 流量的应用或工作流创建智能体。该智能体会生成一个供客户端使用的虚拟密钥。

创建智能体

将智能体绑定到部门，选择环境，设置可选的预算和速率限制控制，然后将其绑定到主密钥。向导完成后，复制生成的虚拟密钥。

5. 在应用中使用虚拟密钥

创建智能体后，请在应用中直接使用其虚拟密钥。最简单的方式是保留 OpenAI SDK，将其指向 Alephant，并在 Authorization 请求头中发送虚拟密钥。随后 Alephant 会将此调用视为智能体流量：它可以路由模型请求、执行策略、记录成本，并将请求关联到智能体 ID、运行 ID 和会话。

1import OpenAI from "openai";
2
3const openai = new OpenAI({
4  baseURL: "https://ai.alephant.io/v1",
5  apiKey: process.env.ALEPHANT_VIRTUAL_KEY,
6  defaultHeaders: {
7    "Alephant-Agent-Id": "agt_support_bot_8f3a",
8    "Alephant-Run-Id": "run_quickstart_001",
9    "alephant-session-id": "session-1778033532814",
10    "Alephant-Cache-Enabled": "true",
11  },
12});
13
14const response = await openai.chat.completions.create({
15  model: "gpt-4o-mini",
16  messages: [{ role: "user", content: "Hello from Alephant" }],
17});
18
19console.log(response.choices[0]?.message?.content);

Alephant-Agent-Id 标识智能体，Alephant-Run-Id 标识一次任务执行，alephant-session-id 将相关请求归入一个用户或智能体会话。工作区配置支持时，Alephant-Cache-Enabled 会启用缓存行为。

6. 从命令行运行 Alephant MCP

Alephant MCP 以 @alephantai/mcp 的形式发布。请直接使用智能体的虚拟密钥运行它：

$ALEPHANT_API_BASE_URL=https://alephant.io \
>ALEPHANT_VIRTUAL_KEY=vk-... \
>npx -y @alephantai/mcp

运行一次性审计以验证连接：

$ALEPHANT_API_BASE_URL=https://alephant.io \
>ALEPHANT_VIRTUAL_KEY=vk-... \
>npx --yes --package=@alephantai/mcp alephant-mcp --audit

在虚拟密钥模式下，审计会输出密钥范围和计费周期用量摘要。

后续步骤