Hướng Dẫn Sử Dụng Devstral với Cursor và Windsurf qua Openrouter API

Bức tranh phát triển phần mềm không ngừng thay đổi, và trí tuệ nhân tạo đóng vai trò then chốt trong sự chuyển đổi này. Các nhà phát triển hiện đang dựa vào các công cụ hỗ trợ AI để tinh giản quy trình làm việc, tăng năng suất và giải quyết các thách thức mã hóa phức tạp. Trong số các công cụ này, Devstral nổi bật như một giải pháp vượt trội. Được Mistral AI ra mắt cùng với sự hợp tác của All Hands AI, Devstral là một mô hình mã hóa AI mã nguồn mở được thiết kế để nâng cao hiệu quả mã hóa. Giấy phép Apache 2.0 cho phép sử dụng không hạn chế cho cả mục đích cục bộ và thương mại, biến nó thành một lựa chọn linh hoạt cho các nhà phát triển trên toàn thế giới.

Bài đăng trên blog này khám phá cách tích hợp Devstral với các môi trường mã hóa phổ biến như Cursor và Windsurf sử dụng Openrouter API. Bằng cách làm theo hướng dẫn này, bạn sẽ học cách thiết lập, cấu hình và tận dụng khả năng của Devstral để nâng cao trải nghiệm mã hóa của mình.

💡

Trước khi bắt đầu, hãy đảm bảo các API của bạn mạnh mẽ và đáng tin cậy. Để làm được điều này, chúng tôi khuyên dùng Apidog, một công cụ kiểm thử API mạnh mẽ giúp đơn giản hóa việc xác thực và gỡ lỗi. Tải xuống Apidog miễn phí để đảm bảo hiệu suất API liền mạch trong suốt quá trình tích hợp này.

button

Tìm hiểu về Devstral: Nguồn sức mạnh mã hóa mã nguồn mở

Trước khi tích hợp Devstral, bạn cần nắm bắt các tính năng và điểm mạnh cốt lõi của nó. Devstral không chỉ là một mô hình AI khác—nó là một công cụ được xây dựng có mục đích cho các tác vụ mã hóa. Được phát triển bởi Mistral AI, nó vượt trội trong việc hiểu cơ sở mã, tạo mã chính xác và cung cấp năng lượng cho các tác nhân mã hóa thông minh. Việc đào tạo của nó bao gồm một loạt các ngôn ngữ lập trình và framework, cho phép nó đưa ra các đề xuất và giải pháp theo ngữ cảnh.

Tại sao Devstral nổi bật

Hiệu suất của Devstral khiến nó trở nên khác biệt. Trên chuẩn SWE-Bench Verified—một bài kiểm tra nghiêm ngặt về khả năng tạo mã và kỹ thuật—nó vượt qua các mô hình mã nguồn mở hàng đầu như Gemma 3 27B của Google và V3 của DeepSeek. Chuẩn này đo lường khả năng của một mô hình trong việc xử lý các tác vụ kỹ thuật phần mềm trong thế giới thực, chẳng hạn như chỉnh sửa tệp và giải quyết các trường hợp kiểm thử. Do đó, Devstral chứng tỏ mình là một người bạn đồng hành đáng tin cậy cho các nhà phát triển giải quyết các dự án phức tạp.

Hơn nữa, bản chất mã nguồn mở của nó theo giấy phép Apache 2.0 mang lại sự linh hoạt chưa từng có. Bạn có thể sử dụng, sửa đổi và phân phối Devstral mà không bị hạn chế. Sự cởi mở này thúc đẩy sự hợp tác và đổi mới, cho phép các nhà phát triển điều chỉnh mô hình theo nhu cầu cụ thể. Đối với các dự án quan tâm đến quyền riêng tư, bạn có thể triển khai Devstral cục bộ, đảm bảo dữ liệu luôn an toàn.

Khả năng tích hợp

Devstral tích hợp liền mạch với các framework như OpenHands và SWE-Agent. Các framework này xác định cách AI tương tác với cơ sở mã và bộ kiểm thử, khiến Devstral trở nên lý tưởng để xây dựng các tác nhân mã hóa tự động. Cho dù bạn đang cải thiện quy trình làm việc hiện có hay tạo ra một giải pháp tùy chỉnh, Devstral đều thích ứng dễ dàng.

Tóm lại, Devstral kết hợp AI tiên tiến với triết lý mã nguồn mở, định vị nó như một công cụ hàng đầu cho các nhà phát triển hiện đại. Tiếp theo, hãy chuẩn bị môi trường của bạn để khai thác sức mạnh của nó.

Thiết lập môi trường phát triển của bạn

Để sử dụng Devstral với Cursor hoặc Windsurf, trước tiên bạn phải thiết lập một nền tảng vững chắc. Phần này sẽ hướng dẫn bạn các điều kiện tiên quyết và quy trình thiết lập. Thực hiện theo các bước này một cách cẩn thận để tránh gặp trục trặc trong quá trình tích hợp.

Điều kiện tiên quyết

Truy cập Devstral
Nhận Devstral thông qua kho lưu trữ chính thức hoặc Openrouter API. Để truy cập API, hãy đăng ký tại Openrouter và lấy khóa API. Khóa này kết nối trình chỉnh sửa của bạn với khả năng của Devstral.

Cài đặt Cursor hoặc Windsurf

Cursor: Tải xuống và cài đặt phiên bản mới nhất của trình chỉnh sửa mã hỗ trợ AI này từ trang web chính thức của nó. Cursor nâng cao khả năng mã hóa bằng các đề xuất và tự động hóa thông minh.

Windsurf: Đảm bảo bạn có phiên bản mới nhất, mặc dù các chi tiết cụ thể có thể khác nhau. Đối với hướng dẫn này, chúng tôi sẽ tập trung chủ yếu vào Cursor, vì các chi tiết của Windsurf ít được xác định rõ hơn. Quá trình này vẫn có thể áp dụng cho các công cụ tương tự.

Khóa API Openrouter
Lưu trữ khóa API của bạn một cách an toàn—bạn sẽ cấu hình nó trong trình chỉnh sửa của mình ngay sau đây.

Apidog để kiểm thử API
Cài đặt Apidog để xác thực các điểm cuối API của bạn. Công cụ này đảm bảo Openrouter API phản hồi chính xác, giúp bạn tiết kiệm thời gian gỡ lỗi sau này.

Tích hợp Devstral với Cursor

Cursor nâng cao khả năng mã hóa với các tính năng hỗ trợ AI, và kết hợp nó với Devstral thông qua Openrouter API sẽ khuếch đại tiềm năng của nó. Thực hiện theo các bước sau để tích hợp chúng một cách hiệu quả.

Quy trình cấu hình

Thêm Khóa API Openrouter

Mở Cursor và điều hướng đến Cài đặt > Cấu hình AI.
Tìm trường khóa API, dán khóa Openrouter của bạn và lưu.

Chọn Devstral làm Mô hình của bạn

Trong cùng menu cài đặt, tìm menu thả xuống chọn mô hình.
Chọn Devstral từ danh sách. Cursor hiện định tuyến các yêu cầu thông qua Openrouter đến Devstral.

Kiểm thử tích hợp

Tạo một tệp mới (ví dụ: test.py) và gõ một đoạn mã không đầy đủ, chẳng hạn như def greet(name):.
Cursor sẽ đề xuất các đoạn mã hoàn chỉnh được cung cấp bởi Devstral.
Sử dụng Apidog để giám sát các cuộc gọi API. Thiết lập một yêu cầu để ghi lại các phản hồi từ Openrouter, đảm bảo Devstral xử lý đầu vào của bạn.

Tùy chỉnh cài đặt

Điều chỉnh các tham số như nhiệt độ (ví dụ: 0.7 cho sự sáng tạo cân bằng) và số token tối đa (ví dụ: 100 cho đầu ra ngắn gọn) trong cài đặt AI của Cursor. Thử nghiệm để phù hợp với phong cách mã hóa của bạn.

Mẹo khắc phục sự cố

Nếu các đề xuất không xuất hiện, hãy xác minh khóa API và kết nối internet của bạn.
Kiểm tra nhật ký Apidog để tìm mã lỗi (ví dụ: 401 cho các vấn đề xác thực).
Đảm bảo Devstral được chọn làm mô hình hoạt động.

Sau khi được cấu hình, Cursor sẽ tận dụng trí thông minh của Devstral để hỗ trợ mã hóa theo thời gian thực. Bây giờ, hãy khám phá Windsurf.

Tích hợp Devstral với Windsurf

Mặc dù Windsurf thiếu tài liệu công khai chi tiết, chúng tôi giả định nó là một trình chỉnh sửa mã hoặc IDE hỗ trợ tích hợp AI. Quy trình này tương tự như của Cursor, với những điều chỉnh nhỏ dựa trên giao diện của Windsurf.

Các bước tích hợp chung

Cấu hình API

Truy cập cài đặt hoặc menu plugin của Windsurf.
Nhập khóa Openrouter API của bạn vào trường được chỉ định.

Liên kết Devstral

Chọn Devstral từ bất kỳ tùy chọn mô hình AI nào. Nếu không có, hãy kiểm tra xem có plugin hoặc tiện ích mở rộng nào hỗ trợ Openrouter không.

Xác thực với Apidog

Kiểm thử các điểm cuối API trong Apidog để xác nhận Windsurf giao tiếp với Openrouter. Một yêu cầu mẫu có thể trông như sau:
URL: https://openrouter.ai/api/v1/completions
Headers: Authorization: Bearer YOUR_API_KEY

Tối ưu hóa hành vi

Điều chỉnh cài đặt (nếu có) để tinh chỉnh đầu ra của Devstral, chẳng hạn như tốc độ phản hồi hoặc tần suất đề xuất.

Nếu Windsurf không hỗ trợ nguyên bản các mô hình AI, hãy xem xét một giải pháp trung gian như một tập lệnh hoặc plugin tùy chỉnh. Hiện tại, cách tiếp cận này giả định khả năng tương thích cơ bản.

Ví dụ thực tế: Devstral trong hành động

Để thể hiện giá trị của Devstral, hãy xem xét các trường hợp sử dụng thực tế trong Cursor. Các ví dụ này làm nổi bật khả năng tinh giản các tác vụ mã hóa của nó.

Ví dụ 1: Hoàn thành mã

Hãy tưởng tượng bạn đang viết một hàm Python để tính giai thừa. Bắt đầu gõ:

def factorial(n):

Devstral đề xuất:

def factorial(n):
    if n == 0:
        return 1
    else:
        return n * factorial(n - 1)

Giải pháp đệ quy này giúp tiết kiệm thời gian và đảm bảo độ chính xác. Kiểm thử nó trong Cursor bằng cách gọi print(factorial(5))—mong đợi kết quả là 120.

Ví dụ 2: Tái cấu trúc mã

Xem xét đoạn mã dài dòng này:

numbers = []
for i in range(10):
    if i % 2 == 0:
        numbers.append(i)

Yêu cầu Devstral tái cấu trúc nó. Nó có thể đề xuất:

numbers = [i for i in range(10) if i % 2 == 0]

Biểu thức list comprehension này ngắn gọn và hiệu quả, thể hiện kỹ năng tối ưu hóa của Devstral.

Ví dụ 3: Hỗ trợ gỡ lỗi

Giả sử bạn viết:

def divide(a, b):
    result = a / b

Devstral đánh dấu một lỗi ZeroDivisionError tiềm ẩn và đề xuất:

def divide(a, b):
    if b == 0:
        raise ValueError("Division by zero is not allowed")
    return a / b

Việc sửa lỗi chủ động này nâng cao tính mạnh mẽ của mã. Những ví dụ này minh họa tính hữu ích của Devstral trong các kịch bản mã hóa.

Tối ưu hóa hiệu suất của Devstral

Để tối đa hóa hiệu quả của Devstral, hãy tinh chỉnh hành vi và cách triển khai của nó. Đây là cách thực hiện:

Tinh chỉnh các tham số

Nhiệt độ: Đặt giữa 0.2 (xác định) và 0.8 (sáng tạo) để kiểm soát phong cách đầu ra.
Top-p: Sử dụng 0.9 để lọc các đề xuất ít có khả năng xảy ra, cân bằng chất lượng và sự đa dạng.
Điều chỉnh các cài đặt này trong Cursor để có kết quả tối ưu.

Quản lý ngữ cảnh

Cung cấp ngữ cảnh rõ ràng trong mã của bạn. Sử dụng tên và chú thích mô tả, chẳng hạn như:

# Calculate total sales from a list of transactions
def total_sales(transactions):

Devstral sử dụng điều này để tạo các đề xuất liên quan, cải thiện độ chính xác.

Triển khai cục bộ

Đối với các dự án nhạy cảm, chạy Devstral cục bộ với OpenHands:

Sao chép kho lưu trữ Devstral.
Cài đặt các phụ thuộc (ví dụ: PyTorch).
Cấu hình OpenHands để lưu trữ Devstral trên máy của bạn.

Điều này đảm bảo quyền riêng tư dữ liệu và giảm độ trễ. Kiểm thử các điểm cuối cục bộ với Apidog để xác nhận chức năng.

Kết luận: Nâng cao khả năng mã hóa của bạn với Devstral

Tích hợp Devstral với Cursor hoặc Windsurf thông qua Openrouter API sẽ biến đổi quy trình làm việc phát triển của bạn. Sự linh hoạt mã nguồn mở của nó, kết hợp với khả năng mã hóa hàng đầu, trao quyền cho các nhà phát triển viết mã tốt hơn nhanh hơn. Hướng dẫn này đã trang bị cho bạn các bước để thiết lập, tích hợp và tối ưu hóa Devstral cho nhu cầu của bạn.

Khám phá thêm bằng cách tìm hiểu tài liệu của Devstral hoặc thử nghiệm các tính năng của nó. Và đừng quên—tải xuống Apidog miễn phí để giữ cho các API của bạn ở trạng thái tốt nhất, đảm bảo tích hợp liền mạch mọi lúc.

button