Nhập một ứng dụng LangGraph — một đồ thị và checkpointer của nó
Tệp langgraph.json của một ứng dụng LangGraph — một đồ thị, lưu trạng thái của nó trong PostgreSQL — được aggrega import soạn nháp thành các tệp Aggrega, với mô hình mà đồ thị gọi và image của ứng dụng được trả lời một lần trong một tệp câu trả lời, và được build cho Docker Compose.
Nhập một ứng dụng LangGraph hướng dẫn từng bước: lệnh, những gì nó hỏi, các tệp mà nó ghi và lý do từng dòng có mặt ở đó, quá trình build, và đồ thị đang chạy. Thư mục này chứa từng giai đoạn của hướng dẫn đó:
| thư mục hoặc tệp | nội dung |
|---|---|
source/ | langgraph.json của ứng dụng, .aggrega-config.yaml biến thư mục thành một không gian làm việc, và import-answers.yaml, các giá trị mà không cấu hình nào chứa: mô hình, image của ứng dụng, và tên các Secret của Kubernetes mà một bản build cho Kubernetes đọc khóa và mật khẩu cơ sở dữ liệu từ đó |
draft/ | các tệp mà aggrega import . --target compose đã ghi, không thay đổi, bao gồm cả release.lock, 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 |
Cấu hình được viết cho ví dụ này. Mã của ứng dụng không thuộc ví dụ: quá trình nhập không bao giờ đọc mã đó, và Release chỉ định image mà mã đó chạy trong đó.
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ó:
aggrega scaffold --example import-langgraphSau đó 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:
cd import-langgraphBuild
Lệnh import soạn nháp các tệp Aggrega bên cạnh dự án, trong source/. Nó đối chiếu dự án với catalog của thư viện chuẩn, mà registry mặc định của workspace xuất bản dưới dạng một bản chụp có chữ ký: lần import đầu tiên tải nó về, xác minh nó, giữ nó trong content cache của workspace và nêu tên nó theo digest trong bản ghi mà nó ghi bên cạnh các bản nháp. Một workspace nêu các thư mục catalog của riêng mình — trong AGGREGA_CATALOG_DIRS, hoặc dưới workspace.catalog_dirs — thì thay vào đó import dựa trên các thư mục đó. Lệnh import đọc mô hình và image từ import-answers.yaml, rồi kéo về những gì Release đã soạn nháp phụ thuộc vào, nên quá trình build có thể tiếp theo ngay:
cd sourceaggrega import . --target composeaggrega build --release release.yamlImage mà ví dụ nêu tên đại diện cho image bạn build từ dự án của mình; cách build nó và chạy stack có trong hướng dẫn đượ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-langgraph`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `import-langgraph` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `import-langgraph` 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-langgraph/source`, `source` đặt thành `.` và `target` đặt thành `compose`: công cụ này đọc các câu trả lời nó cần từ `import-answers.yaml` bên cạnh `langgraph.json`, ghi các bản nháp vào `import-langgraph/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-langgraph/source` và `release` đặt thành `release.yaml`, và công cụ `build` với `workspace_root` đặt thành `import-langgraph/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-langgraph/source/dist/`.Kiểm thử
Khi stack đang chạy theo cách hướng dẫn chạy nó, một yêu cầu sẽ đến graph. Route bên dưới là của chính chương trình trong hướng dẫn, một máy chủ HTTP nhỏ trên cổng 8000; chương trình của riêng bạn tự quyết định route của nó. Release công bố graph trên 127.0.0.1:8000, nên yêu cầu được gửi từ máy của bạn:
curl -sS -X POST http://127.0.0.1:8000/threads/order-1234/runs -H 'Content-Type: application/json' \ -d '{"message": "Where is my order 1234? It has not arrived yet."}'{ "thread": "order-1234", "error": "the run failed: OpenAIAuthenticationError: Error code: 401 - Incorrect API key provided: sk-place************-key. [… omitted: where to find an API key]"}Khóa của lần chạy là một giá trị giữ chỗ, vì vậy câu trả lời là việc OpenAI từ chối khóa đó. Trên Kubernetes, hãy chuyển tiếp một cổng cục bộ tới Deployment, vốn không có Service, rồi gửi cùng yêu cầu đó tới nó từ một terminal khác:
kubectl port-forward deploy/support 8000:8000curl -sS -X POST http://127.0.0.1:8000/threads/order-1234/runs -H 'Content-Type: application/json' \ -d '{"message": "Where is my order 1234? It has not arrived yet."}'Câu trả lời vẫn như vậy.