Tài liệu gốc 40 2 phútTiếng Việt + English
agent_docs/core-boundary.mdXem bản gốc Bản dịch tiếng Việt
Bản dịch đầy đủ theo đúng cấu trúc tài liệu; code, liên kết và định danh kỹ thuật được giữ nguyên.
Ranh giới cốt lõi
Khai thác nên mở rộng Pydantic AI thông qua các nguyên thủy công khai. Nó không nên lặng lẽ tạo runtime thứ hai.
Thuộc về lõi AI Pydantic
Bắt đầu trong lõi AI Pydantic khi thay đổi cần:
- ngữ nghĩa vòng lặp agent mới
- các phần tin nhắn được chuẩn hóa mới hoặc hành vi lịch sử tin nhắn
- khả năng tương thích API của nhà cung cấp hoặc ánh xạ dây của nhà cung cấp
- thông tin thực tế về năng lực của mô hình/hồ sơ/nhà cung cấp
- ngữ nghĩa thực thi công cụ chung
- ngữ nghĩa chế độ đầu ra
- nguyên thủy thực thi bền vững
- khả năng chung của móc hoặc thay đổi thứ tự móc
- Hành vi giao thức MCP nên áp dụng cho tất cả người dùng
Việc khai thác có thể phụ thuộc vào những điều này khi lõi lộ ra nguyên thủy bên phải.
Thuộc về khai thác
Harness là ngôi nhà phù hợp cho:
- thành phần khả năng tái sử dụng
- công cụ coding agent và quy trình làm việc repo
- lan can được xây dựng trên móc
- chính sách bộ nhớ và kiên trì
- Chính sách quản lý bối cảnh
- chính sách xử lý đầu ra công cụ
- lập kế hoạch, kỹ năng, theo dõi nhiệm vụ và thành phần agent phụ
- các giá trị mặc định được cho là hữu ích nhưng không cơ bản đối với mọi AI Pydantic người dùng
Quy tắc quyết định
Nếu gói khả năng của bên thứ ba khó triển khai một tính năng một cách chính xác thông qua các API Pydantic AI công khai, không giải quyết vấn đề đó trong khai thác. Xác định nguyên thủy cốt lõi còn thiếu và đề xuất thay đổi đó trước tiên.
Nếu một tính năng chủ yếu là một quyết định chính sách đối với các hook/bộ công cụ/thông báo hiện có, xây dựng nó trong khai thác.