在遊戲橘子新創團隊,由於產品功能快速迭代,開發時,常常要找規則跟功能定義。雖然功能跟規則都清清楚楚地定義在 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