Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

Nhập một ứng dụng Dify — một trợ lý chat trong bản cài đặt Dify

Một ứng dụng chat Dify, được xuất bằng DSL của Dify, được aggrega import nhập thành một Aggregate, một Release và một Manifest để build bản cài đặt Dify của thư viện chuẩn mang theo ứng dụng đó, cho Kubernetes đúng như đã viết.

Nhập một ứng dụng Dify hướng dẫn từng bước: lệnh, các tệp mà nó ghi, quá trình build và một lần chạy những gì nó build. Thư mục này chứa từng giai đoạn của hướng dẫn đó:

thư mụcnội dung
source/ứng dụng, support-assistant.yml; .aggrega-config.yaml biến thư mục thành một không gian làm việc; và import-answers.yaml, câu trả lời cho những gì không ứng dụng nào có thể chứa: tên của các Kubernetes Secret giữ bí mật ứng dụng của bản cài đặt và mật khẩu của chủ sở hữu, cùng email của tài khoản chủ sở hữu
draft/các tệp mà aggrega import support-assistant.yml --target helm đã ghi, không thay đổi, và những gì nó đã in ra: stdout.txt trên đầu ra chuẩn, import.txt trên đầu ra lỗi chuẩn

source/support-assistant.yml được viết cho ví dụ này, theo dạng mà Dify xuất một ứng dụng ở phiên bản DSL 0.7.0.

Trong một bản checkout của kho tài liệu, check.sh chạy lại quá trình nhập, so sánh những gì nó ghi và in ra với draft/, so sánh các khối mà hướng dẫn trích dẫn với các tệp này, và xác thực rồi build những gì quá trình nhập đã ghi. Nó cần catalog thư viện chuẩn (lấy ở đâu) được checkout bên cạnh kho này, hoặc thư mục của catalog đó được chỉ định trong AGGREGA_CATALOG_DIRS.

Tạo ví dụ

Bạn có thể chạy bước nhập của ví dụ này bằng các lệnh bên dưới, hoặc để trợ lý AI của bạn chạy thay bạn.

Ghi ví dụ vào một thư mục mới đặt theo tên của nó:

Terminal window
aggrega scaffold --example import-dify

Sau đó nó in ra các lệnh cần chạy tiếp theo. Lệnh đầu tiên chuyển vào thư mục mới:

Terminal window
cd import-dify

Build

Quá trình nhập soạn nháp các tệp Aggrega bên cạnh dự án, trong source/, lấy từ import-answers.yaml những gì không ứng dụng nào có thể chứa, và kéo về những gì bản build cần. Nó đối chiếu dự án với catalog của thư viện chuẩn, được registry mặc định của không gian làm việc công bố dưới dạng một snapshot có chữ ký: lần nhập đầu tiên tải nó về, xác minh nó, lưu nó trong bộ nhớ đệm nội dung của không gian làm việc và gọi tên nó bằng digest trong bản ghi mà nó viết bên cạnh các bản nháp. Một không gian làm việc chỉ định các thư mục catalog riêng — trong AGGREGA_CATALOG_DIRS, hoặc dưới workspace.catalog_dirs — sẽ nhập dựa trên các thư mục đó thay thế:

Terminal window
cd source
aggrega import support-assistant.yml --target helm
aggrega validate --release release.yaml
aggrega build --release release.yaml

Việc tạo các Secret mà manifest của bản build đọc, và việc chạy chúng, nằm trong hướng dẫn từng bước được liên kết ở trên.

Với trợ lý AI

Một trợ lý AI được thiết lập với các công cụ của Aggrega cũng có thể làm như vậy: hãy dán prompt này vào trợ lý.

Chỉ dùng các công cụ của Aggrega và không tự tạo thư mục nào. Nếu thư mục không gian làm việc chưa có thư mục `import-dify`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `import-dify` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `import-dify` mới, trong đó thư mục `source` chứa những gì ví dụ này nhập. Sau đó gọi công cụ `import` với `workspace_root` đặt thành `import-dify/source`, `source` đặt thành `support-assistant.yml` và `target` đặt thành `helm`: công cụ này đọc các câu trả lời nó cần từ `import-answers.yaml` bên cạnh `support-assistant.yml`, ghi các bản nháp vào `import-dify/source` và kéo về những gì chúng cần. Sau đó gọi công cụ `validate` với `workspace_root` đặt thành `import-dify/source` và `release` đặt thành `release.yaml`, và công cụ `build` với `workspace_root` đặt thành `import-dify/source`, `release` đặt thành `release.yaml` và `write` đặt thành true. Cho tôi biết bản build đã ghi những tệp nào; chúng nằm trong `import-dify/source/dist/`.

Kiểm thử

Được nhập với --target compose và khởi động như phần Trên Docker Compose của hướng dẫn trình bày, bản cài đặt trả lời trên máy này: API tại http://127.0.0.1:5001 và bảng điều khiển tại http://127.0.0.1:3001/signin. Ứng dụng trả lời một tin nhắn được gửi bằng khóa riêng của nó, khóa mà hướng dẫn tạo sau khi đăng nhập, cài đặt nhà cung cấp OpenAI từ marketplace plugin của Dify, nơi mà marketplace_enabled của Release bản nháp cho phép bản cài đặt truy cập, và đặt khóa của nhà cung cấp:

Terminal window
curl -sS http://127.0.0.1:5001/v1/chat-messages \
-H 'Authorization: Bearer <app key>' -H 'Content-Type: application/json' \
-d '{"inputs": {}, "query": "In one short sentence: what does a support plan cover?", "response_mode": "blocking", "user": "test-it"}'

Khóa nhà cung cấp của lần chạy là một giá trị giữ chỗ, bị Dify từ chối bằng thông báo Incorrect API key provided của OpenAI khi được đặt, nên tin nhắn nhận được:

{"code":"provider_not_initialize","message":"Model gpt-4o-mini credentials is not initialized.","status":400}

Được build như trên, cho Kubernetes, và được áp dụng như phần Chạy nó của hướng dẫn áp dụng, API trả lời cùng các yêu cầu tại cùng địa chỉ khi một cổng cục bộ được chuyển tiếp tới Service của nó; lần chạy đã nhận được cùng các phản hồi ở đó:

Terminal window
kubectl port-forward -n <namespace> svc/dify-zdapi-default 5001:5001