部署技能
重建並將作品集聊天代理 Lambda 函式部署至 AWS。
使用時機
- 在更新
WebContent/context/中的任何檔案後 - 在修改
lambda/lambda_function.py後 - 當使用者說「部署」、「重新部署」、「推送至 Lambda」或「更新聊天代理」時
工作流程
- 重建知識庫 — 從背景檔案重新產生
lambda/knowledge_base.json - 清理先前的建置 — 移除舊的
package/目錄與deployment.zip - 安裝相依項目 — 為 Linux/x86_64 目標安裝 Python 套件
- 封裝 — 將處理程式與知識庫複製到套件目錄,建立 ZIP 檔案
- 部署 — 透過 AWS CLI 更新 Lambda 函式程式碼
- 驗證 — 確認部署成功
命令
步驟 1:重建知識庫
python scripts/build_knowledge_base.py
驗證輸出顯示預期的專案數量且無錯誤。
步驟 2:清理並安裝相依項目
cd lambda
rm -rf package/ deployment.zip
pip install -r requirements.txt -t package/ \
--platform manylinux2014_x86_64 \
--only-binary=:all: \
--implementation cp \
--python-version 3.12
--platform 與 --only-binary 旗標可確保編譯的擴充模組是為 Amazon Linux 建置,而非 macOS。
步驟 3:封裝部署 ZIP
cp lambda_function.py knowledge_base.json package/
cd package && zip -r ../deployment.zip . && cd ..
步驟 4:部署至 Lambda
aws lambda update-function-code \
--function-name portfolio-chat-agent \
--zip-file fileb://lambda/deployment.zip
請從儲存庫根目錄執行此命令,以便 fileb:// 路徑能正確解析。
步驟 5:驗證
檢查回應是否包含:
"LastUpdateStatus": "InProgress"或"Successful""FunctionName": "portfolio-chat-agent"- 已更新的
CodeSha256值
設定
| 設定 | 值 |
|---|---|
| 函式名稱 | portfolio-chat-agent |
| 執行環境 | python3.12 |
| 區域 | us-west-1 |
| 記憶體 | 256 MB |
| 逾時 | 30 秒 |
| 架構 | x86_64 |
規則
- 絕不列印或記錄 Anthropic API 金鑰。 如果 AWS CLI 回應包含環境變數,請勿將其回顯給使用者。
- 務必先重建知識庫。 即使僅變更
lambda_function.py,重建知識庫可確保其為最新狀態。 - 請從儲存庫根目錄執行。 部署命令中的
fileb://路徑是相對於目前工作目錄的。 - 除非使用者明確要求更新 API 金鑰,否則請勿修改 Lambda 環境變數。
疑難排解
| 問題 | 解決方案 |
|---|---|
No module named 'pydantic_core._pydantic_core' | pip install 期間遺漏 --platform 旗標 — 相依項目是為 macOS 而非 Linux 建置 |
Unable to load paramfile fileb:// | 工作目錄錯誤 — 請從儲存庫根目錄執行部署命令 |
ResourceNotFoundException | Lambda 函式尚不存在 — 請使用 aws lambda create-function(請參閱 docs/plans/chat-agent/aws-setup.md 步驟 7) |
CodeStorageExceededException | 部署 ZIP 檔案過大 — 請檢查 requirements.txt 中是否有不必要的相依項目 |
參考文件
- aws-setup.md — 完整的 AWS 帳戶設定、IAM 角色、初始 Lambda 建立與 Function URL 設定