API Adaptyv Bio Foundry
Hướng dẫn dùng API và Python SDK của Adaptyv để gửi chuỗi protein vào phòng thí nghiệm đám mây và lấy kết quả thí nghiệm.
Web · APITrung cấp★ 33,030⑂ 3,248Điểm AI 8/10Cập nhật lần cuối: 9 thg 8, 2026
Làm được gì
Adaptyv Bio là một "cloud lab": bạn gửi chuỗi amino acid, phòng thí nghiệm tự động chạy assay (binding, độ bền nhiệt, biểu hiện, phát quang) và trả dữ liệu sau khoảng 21 ngày. Skill này cung cấp cho Claude toàn bộ kiến thức để viết code đúng:
- Cách xác thực bằng Bearer token, đọc
ADAPTYV_API_KEYtừ biến môi trường hoặc.env(không hardcode) - Hai mẫu code: decorator
@lab.experimentvàFoundryClient - Bảng các loại thí nghiệm (affinity, screening, thermostability, expression, fluorescence) và method BLI/SPR
- Vòng đời trạng thái Draft → QuoteSent → InProduction → Done, ai phải hành động ở mỗi bước
- Định dạng chuỗi (đơn giản, đầy đủ, đa chuỗi dùng dấu hai chấm), phân trang, cú pháp filter s-expression và sort
- Xử lý lỗi với
request_id, quản lý token kiểu Biscuit (attenuate/revoke)
Phù hợp với ai
- Nhà nghiên cứu thiết kế protein muốn kiểm chứng binder/kháng thể bằng thí nghiệm thật
- Kỹ sư ML muốn nối pipeline thiết kế protein bằng AI với bước gửi thí nghiệm tự động
- Nhóm đã có tài khoản Adaptyv Foundry cần quản lý nhiều thí nghiệm qua API
Ví dụ sử dụng
- "Gửi 20 ứng viên binder của tôi để sàng lọc BLI với target EGFR, xem báo giá trước" → tìm target, gọi
cost_estimate,create, rồisubmit. - "Tự động hoá hoàn toàn" → sinh code dùng
skip_draft,auto_accept_quotevàwebhook_urlđể nhận thông báo mỗi lần đổi trạng thái. - "Liệt kê các thí nghiệm đã hoàn thành trong năm nay" → tạo truy vấn
filter=and(gte(created_at,2026-01-01),eq(status,done))&sort=desc(created_at)và lấy kết quả.
· · · Hướng dẫn cài đặt · · ·
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục skills/adaptyv từ repo GitHub K-Dense-AI/scientific-agent-skills vào ~/.claude/skills/adaptyv/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/scientific-agent-skills && mkdir -p ~/.claude/skills && cp -r /tmp/scientific-agent-skills/skills/adaptyv ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal và clone repo:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git - Copy skill vào thư mục Claude:
mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/adaptyv ~/.claude/skills/ - Kiểm tra file
references/api-endpoints.mdđã được copy cùng (tài liệu 32 endpoint). - Lấy API key trong sidebar tại foundry.adaptyvbio.com.
- Tạo file
.envở thư mục gốc dự án với dòngADAPTYV_API_KEY=khoá_của_bạn, và thêm.envvào.gitignore. - Với Python 3.10+, cài SDK:
uv pip install "git+https://github.com/adaptyvbio/adaptyv-sdk.git" - Khởi động lại Claude Code và thử yêu cầu: "Tạo thí nghiệm sàng lọc binding EGFR trên Adaptyv".
Xem mã nguồn trên GitHub ↗Giấy phép: MIT