快速入门

1. 初始化客户端

TypeScript

import { ImbraceClient } from "@imbrace/sdk"

const client = new ImbraceClient({
  accessToken: process.env.IMBRACE_ACCESS_TOKEN,
  env: "stable",
})

Python

import os
from dotenv import load_dotenv
from imbrace import ImbraceClient

load_dotenv()

client = ImbraceClient(
    access_token=os.environ["IMBRACE_ACCESS_TOKEN"],
    env="stable",
)

TypeScript

import { ImbraceClient } from "@imbrace/sdk"

const client = new ImbraceClient({
  apiKey:         process.env.IMBRACE_API_KEY,
  organizationId: process.env.IMBRACE_ORGANIZATION_ID,
  env:            "stable",
})

Python

import os
from dotenv import load_dotenv
from imbrace import ImbraceClient

load_dotenv()

client = ImbraceClient(
    api_key=os.environ["IMBRACE_API_KEY"],
    organization_id=os.environ.get("IMBRACE_ORGANIZATION_ID"),
    env="stable",
)

提示

不确定该用哪种凭证？请参见认证 →

---

2. 获取你的面板

面板是 CRM 管道 — 线索、交易、任务或任何结构化数据。此调用只需要你的凭证。

TypeScript

const { data: boards } = await client.boards.list()

for (const board of boards) {
  console.log(board.id, board.name)
}

Python

boards = client.boards.list()

for board in boards.get("data", []):
    board_id = board.get("_id") or board.get("id")
    print(board_id, board.get("name"))

如果你看到了面板列表，说明 SDK 已连接并认证通过。空列表（data: []）只是表示还没有任何面板 — 这没问题，不是错误。

---

3. 下一步

完整流程指南 端到端地介绍了四大工作流。直接跳转到相关章节：

• AI 代理 + streamChat → 完整流程指南 §1
• 工作流 → 完整流程指南 §2
• 知识中心（文件夹、RAG） → 完整流程指南 §3
• 面板与条目（CRM） → 完整流程指南 §4

按命名空间查看 API 参考，请参见资源。