快速入門

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. 擷取您的 Boards

Boards 是 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"))

如果您看到您的 boards 列出，表示 SDK 已連線並通過認證。空清單（data: []）只代表目前還沒有任何 board — 這是正常的，並非錯誤。

---

3. 下一步

完整流程指南逐步說明四大主要工作流程。直接跳至某個章節：

• AI Agent + streamChat → 完整流程指南 §1
• 工作流程 → 完整流程指南 §2
• 知識中心（資料夾、RAG） → 完整流程指南 §3
• Boards 與項目（CRM） → 完整流程指南 §4

如需各命名空間的 API 參考，請參閱資源。