在遊戲橘子新創團隊,由於產品功能快速迭代,開發時,常常要找規則跟功能定義。雖然功能跟規則都清清楚楚地定義在 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 角色創建文檔。
在 IAM 控制台中,點擊左側導航欄的 Roles。
點擊 Create role。
在 Select trusted entity 頁面:
選擇 AWS service。
在 Use case 中選擇 Q Business(如果沒有這個選項,可以選擇 EC2 或其他相關服務,稍後再修改信任策略)。
點擊 Next。
點擊 Create role。
3. 讓你的身份有執行 Amazon Q Business 的權限
在 IAM 控制台中,點擊左側導航欄的 Policies。
搜尋
AmazonQBusinessFullAccess
。點擊 tab > Entities attached > Attach permissions policies,選擇你要啟用服務的身份。
這樣你才能用該身份 create Amazon Q 服務唷~
Step 2: 整合 Confluence API
獲取 Confluence API Token
登錄 Confluence,進入 管理帳號 > 安全性 > 創建和管理 API Token。
生成一個 API Token 並保存好。
Step 3: 設定 Amazon Q Business
1. 創建 Amazon Q Business
登錄 AWS Management Console,搜索 Amazon Q Business。
點擊 Create application,輸入應用名稱(例如
ProductRulesChatbot
)。選擇 Business 作為應用類型。
Create user
登入後就可以用啦~
結果發現問問題他不會回答,因為還沒放資料 XD
2. 配置數據源 Confluence
在 Amazon Q Business 控制台中,點擊 Data source。
Add an index
建完要等 20 分鐘 XDD
選擇 Confluence 作為數據源類型。
輸入 Confluence 的 URL、API Token 和其他必要信息。
URL
Authentication
IAM role
配置數據同步頻率(例如每天同步一次)。
如果有想指定的 space 空間
可以設定
Include patterns
Space key 通常可以從 URL 看到,例如:
https://gamania-group.atlassian.net/wiki/spaces/SPACEKEY
或在 Space 首頁左側導航欄中查看
就完成啦~
記得按「Sync now」同步資料唷!
3. 訓練模型
上傳 Confluence 文件或指定需要索引的頁面。
使用 Amazon Q 的訓練功能,讓模型學習產品規則和相關術語。
成果不錯捏~
缺點是我找不到中文設定啦,可以預設回中文嗎 XD
補充 1:配置數據源 Jira
步驟跟 Confluence Step 2: 整合 Confluence API 很像
在 Amazon Q Business 控制台中,點擊 Data source。
Data Source 選擇 Jira 作為數據源類型。
輸入 Jira 的 URL、API Token 和其他必要信息。
URL
Authentication
在 Jira 建立一個 API Token,步驟同 1. 獲取 Confluence API Token
將 Token 貼過來
username: email
token: 貼上
建立新的 IAM role
指定專案
補充 2:加入更多 user 讓他們可以使用 Amazon Q business
如果我想要加入更多 user,可以到 Manage user access
有兩個選擇:
- Add and assign new users
- Assign existing users and groups
Add and assign new users
直接 create 的話要再去 IAM Identity Center 另外幫 user 設定 password,我是直接用忘記密碼重設,這樣就不用另外去 IAM Identity Center 設定
Assign existing users and groups
先去 IAM Identity Center Add user 之後
再回來用 Assign exiting users and groups
搜尋剛剛加入的 user
Done
–
(待續)
補充 3:配置數據源 Figma
取得 Figma API Token
- 登錄 Figma,進入 Account settings > Personal access tokens。
- Security tab > Personal access tokens
- Generate new token > Generate token
–
恭喜可以用問的,不用找文件啦~ 🎉
個人覺得設定起來很方便,只是要錢錢 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