Chọn xong công cụ, bước tiếp theo là thiết lập đúng cách để không phải làm lại và không rò rỉ khóa. Bài này áp dụng cho cả no-code lẫn pro-code.
Chuẩn bị chung: API key
Dù dùng công cụ nào, agent cũng cần một LLM. Bạn thường cần khóa của Anthropic (Claude) hoặc OpenAI.
- Tạo tài khoản, vào phần API Keys, tạo key mới, đặt tên theo dự án (ví dụ
agent-cskh-prod). - Đặt hạn mức chi tiêu (spend limit) ngay từ đầu để tránh hóa đơn bất ngờ khi agent chạy lặp.
- Không bao giờ dán key vào code hay chat. Dùng biến môi trường / secret manager.
Thiết lập cho nhóm no-code
- Zapier/Make: vào phần Connections/Credentials, thêm khóa OpenAI/Anthropic một lần, các bước sau tham chiếu lại. Không paste key vào từng step.
- n8n (tự host): cài bằng Docker, đặt biến môi trường
N8N_ENCRYPTION_KEY, lưu credential qua UI (được mã hóa). Đặt sau reverse proxy có HTTPS. - Copilot Studio: kết nối qua Azure/Power Platform connector, quản trị khóa bằng Azure Key Vault, phân quyền theo Entra ID.
# n8n bằng Docker (rút gọn)
docker run -d --name n8n -p 5678:5678 \
-e N8N_ENCRYPTION_KEY="$(openssl rand -hex 24)" \
-v n8n_data:/home/node/.n8n \
docker.n8n.io/n8nio/n8n
Thiết lập cho nhóm pro-code
python -m venv .venv && source .venv/bin/activate
pip install anthropic # hoặc: openai / langgraph / crewai / autogen-agentchat
export ANTHROPIC_API_KEY="sk-..." # nên để trong file .env, KHÔNG commit
# .env (thêm vào .gitignore ngay!)
# ANTHROPIC_API_KEY=sk-...
import os
from anthropic import Anthropic
client = Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"])
Một khác biệt cần nắm giữa hai nhóm: no-code lưu credential bên trong nền tảng (được nền tảng mã hóa và quản lý), còn pro-code để credential trong hạ tầng của bạn (biến môi trường, vault). Với no-code, rủi ro lớn nhất là quyền truy cập tài khoản nền tảng — hãy bật xác thực 2 lớp và phân quyền thành viên. Với pro-code, rủi ro lớn nhất là lộ key qua Git hoặc log — hãy chắc chắn .env nằm trong .gitignore và không in key ra log. Ở cả hai nhóm, nguyên tắc chung là: một key cho một mục đích, có hạn mức, và có thể thu hồi độc lập khi nghi ngờ lộ.
Một thói quen tốt nữa là tách key theo môi trường. Dùng một key agent-cskh-dev cho lúc phát triển thử nghiệm (đặt hạn mức thấp, ví dụ vài đô mỗi tháng) và một key agent-cskh-prod riêng cho production. Khi có sự cố lộ key ở môi trường dev, bạn thu hồi mà không làm gián đoạn dịch vụ thật. Đồng thời, việc này giúp bạn đọc hóa đơn rõ ràng: biết chính xác chi phí đến từ thử nghiệm hay từ người dùng thật.
Checklist thiết lập an toàn
- [ ] Key đặt tên theo dự án, có spend limit.
- [ ] Key nằm trong biến môi trường / secret vault, KHÔNG trong code.
- [ ]
.envđã vào.gitignore. - [ ] Có key riêng cho dev và prod (không dùng chung).
- [ ] Đã bật logging/tracing để quan sát lời gọi model.
- [ ] Với n8n tự host: có HTTPS, có backup volume dữ liệu.
Các bước triển khai
- Tạo và giới hạn key.
- Cài công cụ/thư viện theo lựa chọn ở Bài 1–3.
- Nạp key qua biến môi trường, chạy "hello world" gọi model để xác nhận kết nối.
- Bật tracing/log để về sau debug được.
- Tách môi trường dev/prod.
Khung tư duy
> Thiết lập tốt = tách secret khỏi code + giới hạn chi tiêu + quan sát được. Ba thứ này ngăn 90% sự cố vận hành và bảo mật.
Sai lầm thường gặp
- Commit API key lên Git/GitHub: bị bot quét và lạm dụng trong vài phút. Luôn dùng
.gitignorevà secret manager. - Không đặt spend limit: một vòng lặp agent bị lỗi có thể đốt hàng triệu token qua đêm.
- Dùng chung key dev/prod: khó truy vết, khó thu hồi khi lộ.
- n8n tự host chạy HTTP trần, không backup: rủi ro lộ credential và mất toàn bộ workflow.
- Quên bật tracing: đến khi agent hành xử sai thì không có dữ liệu để tìm nguyên nhân.