Phạm vi và Mục tiêu
Một tác nhân tìm kiếm bất động sản chỉ hữu ích khi nó có thể chuyển đổi yêu cầu của người dùng thành một quy trình truy xuất có kiểm soát. Tác nhân không nên trả lời từ trí nhớ hoặc sáng tạo danh sách. Nó nên gọi một công cụ truy xuất, nhận các bản ghi bất động sản có cấu trúc, áp dụng các bộ lọc rõ ràng, xếp hạng các kết quả còn lại, và trả về một danh sách ngắn gọn được tổ chức với lý do về sự liên quan.
Bài học này tập trung vào mối liên kết giữa một tác nhân và một công cụ truy xuất danh sách. Mô hình chính là đơn giản: chuẩn hóa yêu cầu của người dùng thành các tiêu chí tìm kiếm, xác thực các tiêu chí, truy xuất các bản ghi phù hợp, xếp hạng chúng, và định dạng đầu ra cho bước tiếp theo của tác nhân hoặc cho giao diện người dùng. Một hệ thống sản xuất có thể truy xuất dữ liệu từ một cơ sở dữ liệu, một API đối tác, hoặc một chỉ mục tìm kiếm, nhưng giao diện nên giữ ổn định.
Quyết định thiết kế quan trọng nhất là tách biệt truy xuất khỏi lý luận. Truy xuất trả lời các bản ghi nào phù hợp với các ràng buộc. Tác nhân sau đó giải thích lý do tại sao các bản ghi đó có liên quan, xác định thông tin thiếu, và đặt câu hỏi tiếp theo khi truy vấn quá rộng hoặc không hợp lệ.
Định nghĩa Hợp đồng Công cụ Đáng Tin Cậy
Một hợp đồng công cụ mô tả các trường đầu vào mà tác nhân được phép gửi và hình dạng đầu ra mà nó có thể mong đợi. Ví dụ, một yêu cầu chuẩn hóa có thể chứa một thành phố, giá tối thiểu, giá tối đa, số lượng phòng ngủ tối thiểu, loại bất động sản, và các tính năng ưu tiên tùy chọn. Các trường này nên có kiểu rõ ràng và quy tắc xác thực.
Tác nhân không nên gửi một đoạn văn không có cấu trúc trực tiếp đến một chức năng cơ sở dữ liệu. Ngôn ngữ tự nhiên như Tôi muốn một ngôi nhà cho gia đình gần trung tâm thành phố dưới một ngân sách nhất định phải được chuyển đổi thành các giá trị rõ ràng. Nếu yêu cầu không cung cấp một giá trị cần thiết, tác nhân nên yêu cầu làm rõ hoặc áp dụng một giá trị mặc định đã được tài liệu hóa. Nó không bao giờ nên đoán một giới hạn giá hoặc vị trí một cách im lặng.
Một đầu ra hữu ích bao gồm các tiêu chí ban đầu, số lượng kết quả, và một danh sách các bất động sản đã được chuẩn hóa. Mỗi bất động sản nên bao gồm một định danh ổn định, địa chỉ hoặc vị trí, giá, số phòng ngủ, loại bất động sản, các tính năng có sẵn, và một điểm số liên quan hoặc giải thích về sự phù hợp. Các định danh ổn định rất quan trọng vì các bước sau có thể cần truy xuất đầy đủ chi tiết, so sánh các bất động sản, hoặc lưu một danh sách ngắn.

Xây dựng Quy trình Truy xuất
Quy trình nên bắt đầu bằng việc xác thực. Kiểm tra rằng các trường bắt buộc tồn tại, các giá trị số thực sự là số, giá tối thiểu không lớn hơn giá tối đa, và các giá trị phân loại như loại bất động sản được hỗ trợ. Các lỗi xác thực nên rõ ràng đủ để đại lý có thể khắc phục. Một thông điệp như max_price phải lớn hơn hoặc bằng min_price hữu ích hơn một lỗi chung chung.
Sau khi xác thực, áp dụng các bộ lọc cứng trước. Thành phố, khoảng giá, số phòng ngủ tối thiểu và loại bất động sản thường là những ràng buộc cứng vì việc vi phạm chúng khiến một bất động sản không phù hợp. Chỉ sau bước lọc này, quy trình mới nên tính toán độ liên quan. Điều này ngăn chặn một danh sách hấp dẫn nhưng không hợp lệ xếp hạng cao hơn một bất động sản thực sự đáp ứng yêu cầu.
Việc xếp hạng nên minh bạch. Trong một quy trình cơ bản, một bất động sản có thể nhận điểm cho việc phù hợp với các tính năng ưa thích, nằm trong ngân sách một cách thoải mái, hoặc đáp ứng nhiều hơn yêu cầu số phòng ngủ tối thiểu. Điểm số không thay thế cho các quy tắc kinh doanh. Nó là một cơ chế sắp xếp giúp đại lý trình bày một danh sách ngắn gọn có thể quản lý.
Ví dụ Python có thể chạy
Chương trình sau sử dụng một bộ sưu tập danh sách trong bộ nhớ để có thể chạy mà không cần thông tin xác thực bên ngoài hoặc dịch vụ không tài liệu. Hàm truy xuất đại diện cho ranh giới nơi một cơ sở dữ liệu thực hoặc API danh sách có thể được kết nối sau này. Đầu vào của nó là một từ điển tiêu chí đã chuẩn hóa. Đầu ra của nó là một từ điển có tổ chức chứa số lượng và các bất động sản đã xếp hạng.
Đối với đầu vào mẫu, chương trình trả về hai ngôi nhà ở Austin trong khoảng giá và yêu cầu số phòng ngủ đã chỉ định. Bất động sản có cả hai tính năng ưa thích xếp hạng cao hơn bất động sản còn lại. Trong một đại lý thực, đối tượng kết quả có thể được chuyển đến một bước tạo phản hồi giải thích danh sách ngắn mà không thay đổi các sự kiện đã truy xuất.
Kết nối Công cụ với Đại lý
Khi kết nối quy trình này với một framework đại lý, hãy công khai hoạt động truy xuất như một công cụ với một sơ đồ đã tài liệu. Đại lý nên quyết định khi nào gọi nó, nhưng công cụ nên sở hữu việc xác thực và lọc. Điều này tạo ra một ranh giới rõ ràng: đại lý diễn giải ý định, trong khi lớp truy xuất thực thi các quy tắc dữ liệu.
Một chuỗi đại lý thực tế là xác định các ràng buộc thiếu, sản xuất tiêu chí đã chuẩn hóa, gọi công cụ truy xuất, kiểm tra số lượng kết quả và chọn phản hồi tiếp theo. Nếu số lượng là không, đại lý nên giải thích các ràng buộc cứng nào đã không tạo ra kết quả và hỏi xem người dùng có muốn mở rộng ngân sách, thay đổi vị trí, giảm yêu cầu số phòng ngủ, hoặc loại bỏ một tính năng ưa thích không.
Nếu số lượng kết quả rất lớn, đại lý không nên đổ mọi bản ghi. Nó nên áp dụng một giới hạn xếp hạng hợp lý hoặc yêu cầu một ràng buộc khác. Giới hạn nên rõ ràng và có thể cấu hình. Trả về một danh sách ngắn với lý do hữu ích hơn là trả về một tải trọng dữ liệu không có cấu trúc.
Các Lỗi Thường Gặp và Tóm Tắt
Một lỗi phổ biến là cho phép mô hình tạo ra các bộ lọc không được hỗ trợ như chất lượng trường học, thời gian đi lại, hoặc tình trạng cải tạo khi nguồn truy xuất không cung cấp những trường đó. Công cụ nên từ chối các trường không xác định hoặc đánh dấu rõ ràng chúng là không được hỗ trợ. Một lỗi khác là trộn lẫn các ràng buộc cứng và sở thích mềm. Một tính năng được ưa chuộng nên ảnh hưởng đến xếp hạng, nhưng không nên loại trừ mọi thuộc tính trừ khi người dùng rõ ràng yêu cầu điều đó.
Kết quả trống cũng cần được xử lý cẩn thận. Một danh sách trống không phải là lỗi kỹ thuật, nhưng nó là một kết quả tìm kiếm có ý nghĩa. Đại lý nên phân biệt giữa không có kết quả và một kết nối thất bại, phản hồi không hợp lệ, thời gian chờ, hoặc vấn đề xác thực. Những trường hợp này yêu cầu các thông điệp người dùng khác nhau và các hành động khôi phục khác nhau.
Mô hình cốt lõi là một công cụ truy xuất đã được xác thực, tiếp theo là xếp hạng minh bạch và trình bày có cấu trúc. Giữ cho hợp đồng công cụ ổn định, bảo tồn các định danh danh sách, phơi bày lỗi rõ ràng, và làm cho mọi lý do xếp hạng có thể truy xuất đến các tiêu chí đầu vào. Nền tảng này có thể hỗ trợ phân tích thị trường, lựa chọn tài sản so sánh, định giá chuẩn, và tìm kiếm tiếp theo mà không thay đổi quy trình làm việc cơ bản.
Bài kiểm tra cuối bài
Ôn lại kiến thức, thử sức và nhận góp ý cho bài làm.