在遊戲橘子新創團隊，由於產品功能快速迭代，開發時，常常要找規則跟功能定義。雖然功能跟規則都清清楚楚地定義在 Confluence、Jira Ticket、Figma，但他們散落各地，要找的時候常常找不到也無從找起。每次要開發功能都要翻半天，尤其是我們的功能按照模組劃分，但模組間還是有模糊不清的地帶，所以常不知道規則到底定義在哪一個模組底下。結果就是點來點去找不到，浪費一堆時間。因此萌生了想要做一個，可以馬上回答我功能的機器人的想法。

原本想用 LangChain 做一個 AI 聊天機器人，《又被醍醐灌頂拉》 的日記有提到。把想法跟大主管 C 說後，大主管 C 建議我玩看看 Amazon Q，於是這個計劃就這樣開始惹。

做完覺得效果不錯，如果貴公司開發文件很齊全，有預算，可以可慮！

Step 1: 準備工作

1. 創建 AWS 帳戶

  • 如果你還沒有 AWS 帳戶，請先註冊一個：AWS 註冊首頁。

  • 登錄 AWS Management Console。

2. 創建 IAM 角色 AWSServiceRoleForQBusiness

  • 為 Amazon Q Business 創建一個 IAM 角色，並授予以下權限：

    • AmazonQFullAccess

    • 訪問 Confluence 和 Figma 的權限（如果需要從外部 API 獲取數據）。

  • 創建 IAM 角色的指南：IAM 角色創建文檔。

  1. 在 IAM 控制台中，點擊左側導航欄的 Roles。

  2. 點擊 Create role。

    create IAM role.png

  3. 在 Select trusted entity 頁面：

    • 選擇 AWS service。

    • 在 Use case 中選擇 Q Business（如果沒有這個選項，可以選擇 EC2 或其他相關服務，稍後再修改信任策略）。

    create IAM role select trusted entity.png

  4. 點擊 Next。

    create IAM role next.png

  5. 點擊 Create role。

    create IAM role.png

3. 讓你的身份有執行 Amazon Q Business 的權限

  1. 在 IAM 控制台中，點擊左側導航欄的 Policies。

  2. 搜尋 AmazonQBusinessFullAccess。

    create policy.png

  3. 點擊 tab > Entities attached > Attach permissions policies，選擇你要啟用服務的身份。

    create policy attach permissions policies.png

    這樣你才能用該身份 create Amazon Q 服務唷～

Step 2: 整合 Confluence API

獲取 Confluence API Token

  • 登錄 Confluence，進入 管理帳號 > 安全性 > 創建和管理 API Token。

    create API token.png

  • 生成一個 API Token 並保存好。

    create API token.png

    create API token.png

    create API token.png

Step 3: 設定 Amazon Q Business

1. 創建 Amazon Q Business

  • 登錄 AWS Management Console，搜索 Amazon Q Business。

    create Amazon Q Business.png

  • 點擊 Create application，輸入應用名稱（例如 ProductRulesChatbot）。

    create Amazon Q Business.png

  • 選擇 Business 作為應用類型。

  • Create user

    create user.png

  • 登入後就可以用啦～

    product rules chatbot.png

    Amazon Q Business chatbot.png

    Amazon Q Business chatbot without data.png

    結果發現問問題他不會回答，因為還沒放資料 XD

2. 配置數據源 Confluence

  • 在 Amazon Q Business 控制台中，點擊 Data source。

    create Amazon Q Business data source.png

  • Add an index

    create Amazon Q Business add index.png

    建完要等 20 分鐘 XDD

    create Amazon Q Business.png

  • 選擇 Confluence 作為數據源類型。

    create Amazon Q Business data source with confluence.png

  • 輸入 Confluence 的 URL、API Token 和其他必要信息。

    • URL

      create Amazon Q Business data source confluence url.png

    • Authentication

      create Amazon Q Business data source confluence authentication.png

    • IAM role

      create Amazon Q Business data source confluence iam role.png

    • 配置數據同步頻率（例如每天同步一次）。

    • 如果有想指定的 space 空間

      create Amazon Q Business data source confluence include patterns.png

      可以設定 Include patterns

      create Amazon Q Business data source confluence space key.png

      Space key 通常可以從 URL 看到，例如：

      https://gamania-group.atlassian.net/wiki/spaces/SPACEKEY

      或在 Space 首頁左側導航欄中查看

就完成啦～

create Amazon Q Business data source confluence sync now.png

記得按「Sync now」同步資料唷！

3. 訓練模型

  • 上傳 Confluence 文件或指定需要索引的頁面。

  • 使用 Amazon Q 的訓練功能，讓模型學習產品規則和相關術語。

成果不錯捏～

Amazon Q Business chatbot with data.png

缺點是我找不到中文設定啦，可以預設回中文嗎 XD

補充 1：配置數據源 Jira

步驟跟 Confluence Step 2: 整合 Confluence API 很像

  • 在 Amazon Q Business 控制台中，點擊 Data source。

  • Data Source 選擇 Jira 作為數據源類型。

  • 輸入 Jira 的 URL、API Token 和其他必要信息。

    • URL

      create Amazon Q Business data source jira url.png

    • Authentication

      在 Jira 建立一個 API Token，步驟同 1. 獲取 Confluence API Token

      create Amazon Q Business data source jira authentication.png

      create Amazon Q Business data source jira authentication.png

      將 Token 貼過來

      username: email

      token: 貼上

      create Amazon Q Business data source jira authentication.png

    • 建立新的 IAM role

      create Amazon Q Business data source jira iam role.png

    • 指定專案

      create Amazon Q Business data source jira project.png

      create Amazon Q Business data source jira project.png

      create Amazon Q Business data source jira project.png

補充 2：加入更多 user 讓他們可以使用 Amazon Q business

如果我想要加入更多 user，可以到 Manage user access

create Amazon Q Business manage user access.png

有兩個選擇：

  1. Add and assign new users
  2. Assign existing users and groups

create Amazon Q Business manage user access add and assign new users.png

  • Add and assign new users

    直接 create 的話要再去 IAM Identity Center 另外幫 user 設定 password，我是直接用忘記密碼重設，這樣就不用另外去 IAM Identity Center 設定

    create Amazon Q Business manage user access add and assign new users.png

  • Assign existing users and groups

    先去 IAM Identity Center Add user 之後

    create Amazon Q Business manage user access add and assign existing users and groups.png

    再回來用 Assign exiting users and groups

    create Amazon Q Business manage user access assign existing users and groups.png

    搜尋剛剛加入的 user

    create Amazon Q Business manage user access assign existing users and groups.png

    Done

–

(待續)

補充 3：配置數據源 Figma

  1. 取得 Figma API Token

    • 登錄 Figma，進入 Account settings > Personal access tokens。

    create Amazon Q Business data source figma personal access token.png

    • Security tab > Personal access tokens

    create Amazon Q Business data source figma personal access token.png

    • Generate new token > Generate token

    create Amazon Q Business data source figma personal access token.png

–

恭喜可以用問的，不用找文件啦～ 🎉

個人覺得設定起來很方便，只是要錢錢 XD

價格的話是 by user 計算
Amazon Q Business Lite $3 per user/mo. (目前用的)
如果用 pro 是 Amazon Q Business Pro$20 per user/mo.

文件的 indexing 使用的是 Starter Index，其定價如下：

  • $0.140 每小時/每單位

  • $0.003 每張圖片（$3/1000 張圖片）

  • 每單位包含：

  • 每月 100 小時的連接器使用量

  • 20,000 份文件或 200 MB 提取文本（取其一）

目前把 Confluence Jira 文件都 index，總共用了

  • Document Count: 8,215

  • Storage Used: 11.05 MiB

這樣算起來 Indexing 一個月大約 100.8 美元 ((其實不是很確定怎麼算 XD

然後前兩個月免費，可以先用免費的 XD

Reference:

  1. Getting started with Amazon Q Business

  2. Prerequisites for connecting Amazon Q Business to Jira