Giới thiệu

Trong thế giới phát triển AI hiện đại, các agent (tác nhân) AI có khả năng thực hiện nhiều nhiệm vụ phức tạp như viết mã, phân tích dữ liệu và tạo nội dung sáng tạo. Tuy nhiên, khi yêu cầu chúng thực hiện các tác vụ thực tế, chẳng hạn như đặt vé máy bay, chúng thường gặp phải khó khăn. Vấn đề không nằm ở khả năng suy luận của chúng, mà là ở cách thực thi các tác vụ yêu cầu chuỗi gọi API đáng tin cậy. Trong bài viết này, chúng ta sẽ tìm hiểu về cách Arazzo Generator và Arazzo Runner giúp xây dựng các quy trình agent đáng tin cậy và hiệu quả hơn.

Tại sao các agent cần điều này?

Khi các agent AI phải thực hiện nhiều thao tác liên tiếp như xác thực, tìm kiếm chuyến bay, kiểm tra tính khả dụng, đặt chỗ, xử lý thanh toán và gửi xác nhận, chúng thường gặp khó khăn. Hầu hết các agent hiện tại sử dụng kỹ thuật lập trình mãu (prompt engineering) dễ vỡ. Nếu bất kỳ bước nào trong chuỗi này gặp lỗi, cả quy trình sẽ bị phá vỡ. Điều này dẫn đến việc agent phải thử lại ngẫu nhiên các bước, truyền tham số không chính xác hoặc từ bỏ hoàn toàn.

Tiêu chuẩn còn thiếu

OpenAPI mô tả các endpoint (điểm cuối) một cách hoàn hảo. Tuy nhiên, nó không mô tả cách mà các endpoint này kết nối với nhau để tạo thành các quy trình. Điều này làm giảm độ tin cậy của các agent. Để giải quyết vấn đề này, Arazzo Specification đã ra đời, nhằm mô tả các quy trình API nhiều bước theo định dạng dễ đọc cho máy.

Cách Arazzo Engine hoạt động

Arazzo Engine bao gồm hai thành phần chính:

• Arazzo Generator: Phân tích các специ OpenAPI và tự động xác định các mẫu quy trình logic bằng AI mà không cần lập bản đồ thủ công.
• Arazzo Runner: Thực hiện các quy trình một cách đáng tin cậy với khả năng xử lý lỗi, thử lại và truyền tham số chính xác.

Ví dụ về Arazzo Generator

Để tạo quy trình từ bất kỳ специ OpenAPI nào, bạn chỉ cần thực hiện lệnh sau:

pip install arazzo-generator
arazzo-generator generate https://api.example.com/openapi.json -o workflows.yaml

Arazzo Generator sẽ phát hiện các bước trong quy trình như sau:

workflows:
  - workflowId: book-flight
    description: Quy trình đặt vé máy bay hoàn chỉnh
    steps:
      - stepId: authenticate
        operationId: login
        outputs:
          authToken: $response.body.token
      - stepId: search-flights
        operationId: searchFlights
        parameters:
          - name: Authorization
            value: $steps.authenticate.outputs.authToken
          - name: origin
            value: $inputs.origin
          - name: destination  
            value: $inputs.destination
        outputs:
          flightOptions: $response.body.flights
      - stepId: create-booking
        operationId: createBooking
        parameters:
          - name: Authorization
            value: $steps.authenticate.outputs.authToken
          - name: flightId
            value: $steps.search-flights.outputs.flightOptions[0].id
        outputs:
          bookingId: $response.body.bookingId
      - stepId: process-payment
        operationId: processPayment
        parameters:
          - name: Authorization
            value: $steps.authenticate.outputs.authToken
          - name: bookingId
            value: $steps.create-booking.outputs.bookingId
          - name: paymentMethod
            value: $inputs.paymentMethod

Thực hiện quy trình với Arazzo Runner

Bây giờ, agent của bạn có thể thực hiện toàn bộ quy trình một cách đáng tin cậy:

from arazzo_runner import ArazzoRunner

runner = ArazzoRunner()
result = runner.execute(
    workflow_file="workflows.yaml",
    workflow_id="book-flight",
    inputs={
        "origin": "NYC",
        "destination": "LAX", 
        "paymentMethod": "card_12345"
    }
)

Những điều cần lưu ý khi sử dụng Arazzo

• Xử lý lỗi: Arazzo Runner giúp xử lý các lỗi trong quy trình, đảm bảo rằng nếu một bước gặp sự cố, các bước còn lại có thể tiếp tục hoạt động.
• Tính nhất quán: Các quy trình được thực hiện theo cách có thể dự đoán, giảm thiểu khả năng gặp lỗi do các thay đổi trong API.

Các trường hợp thực tế mà agent có thể thực hiện

Mua sắm thương mại điện tử

arazzo-generator generate shop-api.yaml --workflow-descriptions "quy trình mua hàng hoàn chỉnh"

Đăng ký người dùng

arazzo-generator generate user-api.yaml --workflow-descriptions "cài đặt người dùng mới"

Xử lý dữ liệu

arazzo-generator generate data-api.yaml --workflow-descriptions "pipeline ETL"

Kết luận

Arazzo Engine mang lại cơ sở hạ tầng cần thiết để các agent hoạt động một cách đáng tin cậy và có thể mở rộng. Bằng cách sử dụng các tiêu chuẩn rõ ràng cho các quy trình API, các agent có thể thực hiện công việc mà không cần phải lo lắng về việc hỏng hóc do các chuỗi prompt dễ vỡ. Hãy thử nghiệm Arazzo ngay hôm nay và khám phá những khả năng mà nó mang lại cho các quy trình của bạn.

Tham gia Hacktoberfest 2025

Arazzo Engine sẽ tham gia Hacktoberfest vào tháng 10 này với hơn 40 vấn đề thân thiện cho người mới bắt đầu. Hãy tham gia cùng chúng tôi và đóng góp vào việc cải thiện quy trình agent!

Câu hỏi thường gặp (FAQ)

Arazzo Generator là gì?

Arazzo Generator là công cụ giúp phát hiện và tạo ra các quy trình API từ các специ OpenAPI một cách tự động.

Arazzo Runner có gì đặc biệt?

Arazzo Runner cho phép thực hiện các quy trình một cách đáng tin cậy với khả năng xử lý lỗi và quản lý tham số chính xác.

Làm thế nào để tôi tham gia Hacktoberfest với Arazzo?

Bạn có thể tham gia bằng cách đóng góp mã cho các vấn đề được liệt kê trên GitHub của Arazzo.

Arazzo có phù hợp với mọi loại agent không?

Có, Arazzo có thể tích hợp với bất kỳ loại agent nào theo tiêu chuẩn OpenAPI.