Skill de Despliegue
Reconstruye y despliega la función Lambda del agente de chat del portafolio en AWS.
Cuándo Usarlo
- Después de actualizar cualquier archivo en
WebContent/context/ - Después de modificar
lambda/lambda_function.py - Cuando el usuario diga "desplegar", "redesplegar", "enviar a Lambda" o "actualizar el agente de chat"
Flujo de Trabajo
- Reconstruir base de conocimiento — Regenerar
lambda/knowledge_base.jsona partir de los archivos de contexto - Limpiar compilación anterior — Eliminar el directorio
package/antiguo ydeployment.zip - Instalar dependencias — Instalar paquetes Python para el objetivo Linux/x86_64
- Empaquetar — Copiar el manejador y la base de conocimiento en el paquete, crear el zip
- Desplegar — Actualizar el código de la función Lambda mediante AWS CLI
- Verificar — Confirmar que el despliegue fue exitoso
Comandos
Paso 1: Reconstruir la Base de Conocimiento
python scripts/build_knowledge_base.py
Verifica que la salida muestre el número esperado de proyectos y no tenga errores.
Paso 2: Limpiar e Instalar Dependencias
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
Las banderas --platform y --only-binary aseguran que las extensiones compiladas se construyan para Amazon Linux, no para macOS.
Paso 3: Empaquetar el Zip de Despliegue
cp lambda_function.py knowledge_base.json package/
cd package && zip -r ../deployment.zip . && cd ..
Paso 4: Desplegar en Lambda
aws lambda update-function-code \
--function-name portfolio-chat-agent \
--zip-file fileb://lambda/deployment.zip
Ejecuta esto desde la raíz del repositorio para que la ruta fileb:// se resuelva correctamente.
Paso 5: Verificar
Comprueba que la respuesta incluya:
"LastUpdateStatus": "InProgress"o"Successful""FunctionName": "portfolio-chat-agent"- Valor de
CodeSha256actualizado
Configuración
| Configuración | Valor |
|---|---|
| Nombre de función | portfolio-chat-agent |
| Runtime | python3.12 |
| Región | us-west-1 |
| Memoria | 256 MB |
| Tiempo de espera | 30 segundos |
| Arquitectura | x86_64 |
Reglas
- Nunca imprimas o registres la clave API de Anthropic. Si la respuesta de AWS CLI incluye variables de entorno, no las muestres de vuelta al usuario.
- Siempre reconstruye la base de conocimiento primero. Incluso si solo cambió
lambda_function.py, la reconstrucción asegura que la base de conocimiento esté actualizada. - Ejecuta desde la raíz del repositorio. La ruta
fileb://en el comando de despliegue es relativa al directorio de trabajo. - No modifiques las variables de entorno de Lambda a menos que el usuario solicite explícitamente actualizar la clave API.
Solución de Problemas
| Problema | Solución |
|---|---|
No module named 'pydantic_core._pydantic_core' | Falta la bandera --platform durante pip install — las dependencias se construyeron para macOS en lugar de Linux |
Unable to load paramfile fileb:// | Directorio de trabajo incorrecto — ejecuta el comando de despliegue desde la raíz del repositorio |
ResourceNotFoundException | La función Lambda no existe aún — usa aws lambda create-function (ver docs/plans/chat-agent/aws-setup.md Paso 7) |
CodeStorageExceededException | El zip de despliegue es demasiado grande — verifica dependencias innecesarias en requirements.txt |
Documentación de Referencia
- aws-setup.md — configuración completa de la cuenta AWS, roles IAM, creación inicial de Lambda y configuración de URL de función