> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.alephant.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.alephant.io/_mcp/server.

# 快速入门指南

> 注册、创建部门、添加提供商 API 密钥、创建智能体，并从命令行开始使用

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

## 1. 注册 Alephant

打开 [Alephant 仪表盘](https://alephant.io/)，创建账户或登录您的工作区。

![注册 Alephant](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/c17ae247a2b52bc82225273c62bdab5ebb0b51e812f89303faa0f9bb06d78639/docs/assets/quickstart-register.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260727%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260727T034929Z&X-Amz-Expires=604800&X-Amz-Signature=419e0454f272fc6fcb78d9fb23c952be76a01311468779291612de22ae352530&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

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

## 2. 创建部门

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

![创建新部门](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/1b638edf1efa2f0d9a8c0fcdc0ad42b1a76660938e491f9de92c64e6ba82ddbe/docs/assets/quickstart-create-department.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260727%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260727T034929Z&X-Amz-Expires=604800&X-Amz-Signature=07ff5d1281529a8e1cce8a85af2e8e94acdb03431ce3683234f3733a4bc179f8&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

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

## 3. 添加 API Key

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

![添加提供商 API 密钥](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/d7274e040843e1565dded7ed0be3428cabcf1eab6e71b0f17aa92927916cabcb/docs/assets/quickstart-add-api-key.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260727%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260727T034929Z&X-Amz-Expires=604800&X-Amz-Signature=dcd5df30c876c5cca5b78c71e687fc61df3eb10f5e9312a55422a54671c072f2&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

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

## 4. 创建智能体

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

![创建智能体](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/alephantai.docs.buildwithfern.com/dfa3ad7405668dabe7ededb9b039c85aabce3f68f40f61b4b3ac64732663ab3c/docs/assets/quickstart-create-agent.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260727%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260727T034929Z&X-Amz-Expires=604800&X-Amz-Signature=3d2726e28d6c7cc37799691ca307d548ced7a537e1e79a0326e5bf1bfec863d0&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

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

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

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

```typescript
import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "https://ai.alephant.io/v1",
  apiKey: process.env.ALEPHANT_VIRTUAL_KEY,
  defaultHeaders: {
    "Alephant-Agent-Id": "agt_support_bot_8f3a",
    "Alephant-Run-Id": "run_quickstart_001",
    "alephant-session-id": "session-1778033532814",
    "Alephant-Cache-Enabled": "true",
  },
});

const response = await openai.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "Hello from Alephant" }],
});

console.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` 的形式发布。请直接使用智能体的虚拟密钥运行它：

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

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

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

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

## 后续步骤

* [配置与模式](/mcp-service/configuration-modes)：选择虚拟密钥模式或管理器模式。
* [使用指南](/mcp-service/usage-guide)：向 Alephant MCP 查询支出、预算、模型和工作区洞察。
* [网关集成](/docs/overview/core-concepts/gateway-integration)：通过 Alephant 发送提供商兼容的 LLM 流量。
* [智能体 ID 和运行 ID](/docs/overview/core-concepts/agent-i-ds-and-run-i-ds)：附加智能体、运行、会话、请求和追踪标识符。