跳至主要内容

REFERENCE

SDK 範例

@asgard-js/core 與 @asgard-js/react 的用法與可以直接操作的範例。

認證狀態

SDK 提供 authState prop,針對認證流程的每個階段渲染對應的 UI。 搭配 onApiKeySubmit 可以做非同步的 API key 驗證。

  1. 支援的狀態​

    狀態UI 行為
    authenticated正常聊天介面
    needApiKey提示使用者輸入 API key
    invalidApiKey錯誤狀態加上重試提示
    loading認證判斷中,顯示 spinner
    error一般錯誤 UI
    subscriptionExpired訂閱到期,顯示升級 CTA
    botNotFoundbot provider 回傳 404 時的封鎖畫面
  2. 程式範例​

    const [authState, setAuthState] = useState<AuthState>("needApiKey");

    <Chatbot
    authState={authState}
    onApiKeySubmit={async (key) => {
    const valid = await validate(key);
    setAuthState(valid ? "authenticated" : "invalidApiKey");
    }}
    {...rest}
    />;

準備好開始了嗎?

想知道 Asgard 怎麼用在你的團隊?跟我們聊聊。

聯絡我們