Giới thiệu về Heylock
Heylock cung cấp một SDK đơn giản giúp bạn thêm các tính năng AI vào các dự án JS/TS với mã lệnh tối thiểu. Trong bài viết này, chúng ta sẽ cùng khám phá cách sử dụng Heylock và các tính năng của nó.
Các bước bắt đầu với Heylock
Để bắt đầu sử dụng Heylock, hãy làm theo 4 bước sau:
1. Đăng ký tài khoản
Đầu tiên, bạn cần tạo một tài khoản trên trang web của Heylock. Đừng lo lắng về số dư, bạn sẽ được cung cấp các tín dụng miễn phí ngay từ đầu. Nếu cần thêm, hãy sử dụng mã khuyến mãi DEV10 để nhận thêm 10 đô la.
2. Tạo một Agent
Khi tài khoản của bạn đã sẵn sàng, hãy nhấp vào nút "Tạo Agent".
3. Lấy khóa Agent
Khi agent mới của bạn đã được lập chỉ mục, hãy cuộn xuống dưới cùng của trang và sao chép khóa từ thẻ khóa. Việc lập chỉ mục có thể mất từ 15 giây đến 5 phút, tùy thuộc vào tình trạng của máy chủ. Bạn có thể tiếp tục theo hướng dẫn và quay lại bước này sau.
4. Cài đặt SDK
Chạy lệnh sau trong console của bạn để cài đặt SDK:
npm i heylockĐảm bảo rằng bạn đã có tệp package.json. Nếu chưa, hãy chạy lệnh sau và sau đó cài đặt gói của chúng tôi:
npm init -yKhởi tạo Agent
Dán dòng lệnh sau, thay thế 'PASTE-AGENT-KEY-HERE' bằng khóa agent của bạn. Dòng lệnh này sẽ tạo đối tượng agent mà bạn sẽ tương tác:
import Heylock from 'heylock';
const agent = new Heylock('PASTE-AGENT-KEY-HERE');Quá trình khởi tạo sẽ tự động diễn ra. Trong thời gian đó, chúng tôi sẽ kiểm tra khóa agent và số dư của bạn.
Cách khắc phục cảnh báo khởi tạo
Sử dụng đoạn mã sau để tránh cảnh báo khi agent của bạn chưa được khởi tạo:
const agent = new Heylock('PASTE-AGENT-KEY-HERE');
agent.onInitialized(() => {
// Mã của bạn ở đây
});Bạn có thể sử dụng các chức năng của agent trước khi khởi tạo, nhưng không đảm bảo sẽ hoạt động chính xác.
Gửi tin nhắn
Hàm gửi tin nhắn là một trong những hàm đơn giản nhất mà bạn có thể sử dụng. Như đã hứa, đây là 2 dòng mã:
// Khởi tạo
const agent = new Heylock(process.env.AGENT_KEY);
// Gửi tin nhắn và in kết quả
console.log(await agent.message('Hello!'));Tin nhắn sẽ tự động được lưu trong lịch sử.
Sắp xếp và lọc mảng
Hãy làm việc với các mảng bằng ngôn ngữ tự nhiên:
// Khởi tạo
const agent = new Heylock(process.env.AGENT_KEY);
// Định nghĩa một mảng
const array = ['a', 2, { name: 'helicopter' }];
// Sắp xếp
const response = await agent.sort(array, 'Sắp xếp theo kích thước cảm nhận');
// In kết quả
console.log(response.array);
// In lý do
console.log(response.reasoning);Lọc cũng tương tự, chỉ cần yêu cầu nó:
// Khởi tạo
const agent = new Heylock(process.env.AGENT_KEY);
// Lọc
const response = await agent.sort([1, 2, 3, 4], 'Chỉ trả về số chẵn');
// In kết quả
console.log(response.array);Hàm này có thể được sử dụng cho các khuyến nghị, lọc thông minh và nhiều tính năng khác. Đó là sức mạnh của AI.
Viết lại văn bản
Bạn muốn thêm chức năng sửa đổi văn bản vào ứng dụng của mình? Đây là cách thực hiện:
// Khởi tạo
const agent = new Heylock(process.env.AGENT_KEY);
// Viết lại
const text = await agent.rewrite('mai english so bed', 'Sửa ngữ pháp và chính tả');
// In kết quả
console.log(text);Xác định thời điểm tương tác
Muốn tương tác với khách truy cập qua agent AI của bạn? Nó sẽ biết khi nào nên xuất hiện. Hãy yêu cầu:
// Khởi tạo
const agent = new Heylock(process.env.AGENT_KEY);
// Kiểm tra
const response = await agent.shouldEngage('Tương tác khi khách truy cập có vẻ bế tắc');
// In quyết định
console.log(response.shouldEngage);
// In lý do
console.log(response.reasoning);Quản lý ngữ cảnh
Thêm ngữ cảnh cho các hành động của người dùng là một thực hành tốt. Ví dụ, khi một khách truy cập truy cập một trang, nhấp vào một nút, hoặc di chuột qua một cái gì đó, tất cả đều có thể hữu ích cho các agent AI. Ví dụ:
// Khởi tạo
const agent = new Heylock(process.env.AGENT_KEY);
// Thêm một mục ngữ cảnh
const id = agent.addContextEntry('Người dùng đã truy cập trang giá');
// Đọc
console.log(agent.getContextString()); // Người dùng đã truy cập trang giá bây giờ.
// Chỉnh sửa
agent.modifyContextEntry(id, 'Người dùng đã truy cập trang giá hai lần');
// Xóa
agent.removeContextEntry(id);Tóm lược
Đây chỉ là một phần nhỏ trong những gì bạn có thể làm với các agent AI của Heylock. Để biết thêm thông tin, hãy truy cập tài liệu chính thức của chúng tôi và các hướng dẫn khác.
Câu hỏi thường gặp (FAQ)
1. Heylock có miễn phí không?
Có, bạn sẽ nhận được tín dụng miễn phí khi tạo tài khoản mới.
2. Tôi có thể sử dụng Heylock cho dự án của mình không?
Có, Heylock rất dễ tích hợp vào các dự án JS/TS của bạn.
3. Tôi có thể tìm thêm tài liệu ở đâu?
Tài liệu chi tiết có sẵn trên trang web chính thức của Heylock.
Hãy bắt đầu xây dựng ngay hôm nay!
