Agent, Runner, and Trace Classes

1. Agent – Bộ não của hệ thống

Vai trò:

Đây là nơi bạn định nghĩa hành vi của agent:

• Cung cấp hướng dẫn (instructions).

• Chỉ định tools mà agent có thể sử dụng.

• Là trung tâm ra quyết định (planning + tool selection).

Cách dùng:

from openai import Agent

agent = Agent(
    instructions="Bạn là trợ lý chuyên đọc hóa đơn và trả lời câu hỏi về chúng.",
    tools=[invoice_parser, pdf_reader],
)

2. Runner – Bộ máy thực thi nhiệm vụ

Vai trò:

Là một instance hoạt động của Agent, cho phép bạn gọi .run() để xử lý một tác vụ cụ thể.

Mỗi khi bạn muốn agent xử lý một yêu cầu đầu vào, bạn tạo một runner từ agent, rồi gọi runner.run(input).

Cách dùng:

runner = agent.runner()
output = runner.run("Đọc hóa đơn.pdf và cho biết tổng số tiền.")

3. trace() – Công cụ giám sát

Vai trò:

Dùng để theo dõi toàn bộ quá trình suy luận và hành động của agent:

• Ghi lại quá trình lựa chọn tools

• Theo dõi các bước lập kế hoạch (planning)

• Hữu ích để debug hoặc audit

Cách dùng:

from openai import trace

with trace():
    runner = agent.runner()
    result = runner.run("Phân tích file dữ liệu tài chính.xlsx")

Có thể tích hợp với giao diện trực quan của OpenAI để xem toàn bộ flow tác vụ.

Tóm tắt mối quan hệ:

graph TD;
    Agent[Agent: Định nghĩa hành vi và tools]
    Runner[Runner: Gọi tác vụ cụ thể qua .run()]
    Trace[trace(): Ghi log toàn bộ quá trình]

    Agent --> Runner
    Runner -->|run(input)| Task[Thực hiện tác vụ]
    Trace --> Runner