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 dự án CrewAI — một crew gồm hai agent

Các khai báo agent và tác vụ của một dự án CrewAI theo bố cục cổ điển — hai agent trên cùng một mô hình OpenAI, mỗi agent một tác vụ — được aggrega import soạn nháp thành các tệp Aggrega, với image mà chương trình của crew chạy trong đó đượ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 dự án CrewAI 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 mỗi dòng có mặt ở đó, quá trình build, và crew khi 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ệpnội dung
source/các khai báo của dự án, src/support_brief/config/agents.yaml và tasks.yaml, .aggrega-config.yaml biến thư mục thành một không gian làm việc, và src/support_brief/import-answers.yaml, các giá trị mà không khai báo nào chứa: image của mỗi agent, và tên của Kubernetes Secret mà một bản build cho Kubernetes đọc khóa OpenAI từ đó
draft/các tệp mà aggrega import src/support_brief --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ác khai báo được viết cho ví dụ này. Chương trình của crew không thuộc ví dụ: quá trình nhập không bao giờ đọc chương trình nào, và Release chỉ định image mà chương trình 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ó:

Terminal window
aggrega scaffold --example import-crewai

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-crewai

Build

Quá trình nhập 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, đượ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ế. Quá trình nhập đọc các image từ src/support_brief/import-answers.yaml, rồi kéo về những gì mà Release được soạn nháp phụ thuộc vào, để bước build có thể theo ngay sau:

Terminal window
cd source
aggrega import src/support_brief --target compose
aggrega build --release release.yaml

Image 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-crewai`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `import-crewai` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `import-crewai` 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-crewai/source`, `source` đặt thành `src/support_brief` 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 trong thư mục `src/support_brief`, ghi các bản nháp vào `import-crewai/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-crewai/source` và `release` đặt thành `release.yaml`, và công cụ `build` với `workspace_root` đặt thành `import-crewai/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-crewai/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 crew. 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ố nhà nghiên cứu trên 127.0.0.1:8000 và người viết trên 127.0.0.1:8001, nên yêu cầu được gửi tới nhà nghiên cứu từ máy của bạn:

Terminal window
curl -sS -X POST http://127.0.0.1:8000/kickoff -H 'Content-Type: application/json' \
-d '{"question": "Which support plan covers a weekend outage, and what does it cost?"}'
{
"error": "the crew failed: AuthenticationError: Error code: 401 - {'error': {'message': 'Incorrect API key provided: sk-place************-key. [… omitted: where to find an API key, and the error's type and code]"
}

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:

Terminal window
kubectl port-forward deploy/researcher 8000:8000
Terminal window
curl -sS -X POST http://127.0.0.1:8000/kickoff -H 'Content-Type: application/json' \
-d '{"question": "Which support plan covers a weekend outage, and what does it cost?"}'

Câu trả lời vẫn như vậy.