Compétence de Déploiement
Reconstruire et déployer la fonction Lambda de l'agent de chat du portfolio sur AWS.
Quand l'utiliser
- Après avoir mis à jour un fichier dans
WebContent/context/ - Après avoir modifié
lambda/lambda_function.py - Quand l'utilisateur dit « déployer », « redéployer », « pousser vers Lambda » ou « mettre à jour l'agent de chat »
Flux de travail
- Reconstruire la base de connaissances — Régénérer
lambda/knowledge_base.jsonà partir des fichiers de contexte - Nettoyer la construction précédente — Supprimer l'ancien répertoire
package/etdeployment.zip - Installer les dépendances — Installer les paquets Python pour la cible Linux/x86_64
- Empaqueter — Copier le gestionnaire et la base de connaissances dans le paquet, créer un zip
- Déployer — Mettre à jour le code de la fonction Lambda via AWS CLI
- Vérifier — Confirmer que le déploiement a réussi
Commandes
Étape 1 : Reconstruire la base de connaissances
python scripts/build_knowledge_base.py
Vérifiez que la sortie montre le nombre de projets attendu et aucune erreur.
Étape 2 : Nettoyer et installer les dépendances
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
Les options --platform et --only-binary garantissent que les extensions compilées sont construites pour Amazon Linux, pas pour macOS.
Étape 3 : Empaqueter le zip de déploiement
cp lambda_function.py knowledge_base.json package/
cd package && zip -r ../deployment.zip . && cd ..
Étape 4 : Déployer vers Lambda
aws lambda update-function-code \
--function-name portfolio-chat-agent \
--zip-file fileb://lambda/deployment.zip
Exécutez cette commande depuis la racine du dépôt pour que le chemin fileb:// se résolve correctement.
Étape 5 : Vérifier
Vérifiez que la réponse inclut :
"LastUpdateStatus": "InProgress"ou"Successful""FunctionName": "portfolio-chat-agent"- Une valeur mise à jour de
CodeSha256
Configuration
| Paramètre | Valeur |
|---|---|
| Nom de la fonction | portfolio-chat-agent |
| Runtime | python3.12 |
| Région | us-west-1 |
| Mémoire | 256 Mo |
| Délai d'attente | 30 secondes |
| Architecture | x86_64 |
Règles
- Ne jamais afficher ou journaliser la clé API Anthropic. Si la réponse AWS CLI inclut des variables d'environnement, ne les renvoyez pas à l'utilisateur.
- Toujours reconstruire la base de connaissances d'abord. Même si seulement
lambda_function.pya changé, la reconstruction garantit que la base de connaissances est à jour. - Exécuter depuis la racine du dépôt. Le chemin
fileb://dans la commande de déploiement est relatif au répertoire de travail. - Ne pas modifier les variables d'environnement Lambda sauf si l'utilisateur demande explicitement de mettre à jour la clé API.
Dépannage
| Problème | Solution |
|---|---|
No module named 'pydantic_core._pydantic_core' | L'option --platform manque lors de l'installation pip — les dépendances ont été construites pour macOS au lieu de Linux |
Unable to load paramfile fileb:// | Mauvais répertoire de travail — exécutez la commande de déploiement depuis la racine du dépôt |
ResourceNotFoundException | La fonction Lambda n'existe pas encore — utilisez aws lambda create-function (voir docs/plans/chat-agent/aws-setup.md Étape 7) |
CodeStorageExceededException | Le zip de déploiement est trop volumineux — vérifiez les dépendances inutiles dans requirements.txt |
Documentation de référence
- aws-setup.md — configuration complète du compte AWS, rôles IAM, création initiale de Lambda et configuration de l'URL de la fonction