Bỏ qua đến nội dung chính

The text editor tool

📖 Nội dung bài học

Họ phông chữ

Tóm tắt

Lưu ý quan trọng: ID công cụ mới nhất cho công cụ soạn thảo văn bản có thể được tìm thấy trong tài liệu AWS tại đây: https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-tool-use.html#model-parameters-anthropic-anthropic-defined-tools

Công cụ soạn thảo văn bản là khả năng tích hợp sẵn của Claude, cho phép truy cập hệ thống tệp và khả năng chỉnh sửa văn bản. Khác với các công cụ khác, nơi bạn viết cả lược đồ và triển khai, Claude đã biết cách yêu cầu các thao tác soạn thảo văn bản - bạn chỉ cần xử lý các yêu cầu đó.

Công cụ soạn thảo văn bản làm gì

Công cụ này cho phép Claude làm việc với các tệp và thư mục như một kỹ sư phần mềm:

  • Xem nội dung tệp hoặc thư mục
  • Xem các dòng cụ thể trong một tệp
  • Thay thế văn bản trong tệp
  • Tạo tệp mới
  • Chèn văn bản ở các số dòng cụ thể
  • Hoàn tác các chỉnh sửa gần đây

Cách nó hoạt động

Công cụ soạn thảo văn bản khác với các công cụ tùy chỉnh vì chỉ có lược đồ JSON được tích hợp vào Claude. Bạn vẫn cần cung cấp việc triển khai thực tế.

Khi bạn tạo các công cụ tùy chỉnh, bạn viết cả hai phần - lược đồ cho Claude biết về công cụ và hàm thực sự thực hiện công việc. Với Công cụ soạn thảo văn bản, Claude đã có lược đồ, nhưng bạn phải viết các hàm để xử lý các yêu cầu của Claude để xem, chỉnh sửa hoặc tạo tệp.

Thiết lập công cụ

Để dùng Công cụ soạn thảo văn bản, bạn cần cung cấp các tên công cụ cụ thể khác nhau tùy theo phiên bản Claude:


text_editor = "text_editor_20250124"

text_editor = "text_editor_20241022"

Bạn cũng cần sửa đổi hàm chat của bạn để chấp nhận tham số text editor và bao gồm nó trong cấu hình model.

Lệnh công cụ

Khi Claude muốn dùng text editor, nó gửi lại các yêu cầu dùng công cụ với các lệnh cụ thể:

Việc triển khai của bạn cần xử lý cả năm lệnh. Dưới đây là cấu trúc cơ bản để xử lý các yêu cầu này:

def run_tool(tool_name, tool_input):
    if tool_name == "str_replace_editor":
        command = tool_input.get("command", "")
        if command == "view":
            path = tool_input.get("path", "")
            return text_editor_tool.view(path)
        elif command == "str_replace":
            path = tool_input.get("path", "")
            old_str = tool_input.get("old_str", "")
            new_str = tool_input.get("new_str", "")
            return text_editor_tool.str_replace(path, old_str, new_str)
        # ... handle other commands

Ví dụ: Phân tích tệp

Đây là cách công cụ hoạt động trong thực tế. Khi bạn yêu cầu Claude "Viết một câu mô tả về mã trong tệp ./main.py", điều này sẽ xảy ra:

Claude gửi một yêu cầu dùng công cụ với {"command": "view", "path": "./main.py"}. Máy chủ của bạn dùng lớp TextEditorTool để đọc tệp và trả về nội dung. Sau đó, Claude cung cấp phân tích của nó dựa trên mã mà nó đã đọc.

Ứng dụng thực tế

Công cụ soạn thảo văn bản về cơ bản biến Claude thành một trợ lý mã có thể:

  • Đọc mã hiện có và cung cấp phân tích
  • Tạo tệp và hàm mới
  • Sửa đổi mã hiện có
  • Thiết lập các tệp kiểm thử
  • Refactor mã trên nhiều tệp

Ví dụ, bạn có thể yêu cầu Claude "viết một hàm để tính pi đến chữ số thứ 5 trong main.py, sau đó tạo một tệp test.py để kiểm tra nó." Claude sẽ đọc tệp hiện có, thêm hàm mới, tạo tệp kiểm thử và viết các bài kiểm tra toàn diện - tất cả tự động dùng các lệnh text editor.

Điều này giúp bạn có thể xây dựng các công cụ phát triển hỗ trợ AI tương tự như các trình soạn thảo mã hiện đại với các tính năng AI tích hợp, nơi bạn có thể yêu cầu các thay đổi mã và triển khai chúng trực tiếp trong hệ thống tệp của mình.

Tải xuống

🔁 Bài học liên quan

📚 Nguồn & ghi nhận

Bài học có hữu ích không?

Góp ý / Báo lỗiPhát hiện sai sót hoặc có ý tưởng cải thiện?