Kính hiển vi

Macroscope chạy Macroscope cục bộ mã đánh giá từ bên trong một agent: một công cụ sẽ được cài đặt macroscope CLI, phân tích các kết quả được truyền trực tuyến và trả về chúng dưới dạng dữ liệu có cấu trúc. các agent xác nhận từng phát hiện và sửa những cái thực sự bằng các công cụ mà nó đã có có -- khả năng này chỉ hiển thị những phát hiện.

Nguồn

Mặc dù Pydantic AI Harness có trên các bản phát hành 0.x nhưng API có thể thay đổi giữa các bản phát hành nhỏ; khi đó, cảnh báo ngừng sử dụng và hướng dẫn di chuyển ghi chú phát hành sẽ cho bạn (hoặc người đại diện của bạn) biết chính xác cách nâng cấp. Xem chính sách phiên bản.

vấn đề

Macroscope xem xét các phát hiện về luồng và khác biệt của nhánh hiện tại, nhưng nó đưa ra làm plugin soạn thảo (Claude Code, Codex, Cursor, OpenCode). Không có cách nào để cung cấp cho AI agent Pydantic vòng lặp xem xét và sửa lỗi tương tự từ mã của riêng bạn.

Cách sử dụng

from pydantic_ai import Agent
from pydantic_ai_harness import Macroscope

agent = Agent('anthropic:claude-sonnet-5', capabilities=[Macroscope()])

result = agent.run_sync('Run a Macroscope review and fix any real findings.')
print(result.output)

các macroscope CLI phải được cài đặt và xác thực trên máy chủ trước:

1. Cài đặt: curl -sSL https://raw.githubusercontent.com/prassoai/macroscope-local/main/install.sh | bash
2. Đăng nhập và chọn không gian làm việc bằng cách chạy macroscope một lần.

Khả năng không thể cài đặt hoặc xác thực thay mặt bạn. Nếu nhị phân là thiếu, công cụ trả về lệnh cài đặt; nếu việc xem xét không bao giờ bắt đầu (thường là do bạn chưa đăng nhập), công cụ sẽ yêu cầu tổng đài viên chạy macroscope để hoàn tất thiết lập.

Công cụ này gọi macroscope codereview --raw để phát trực tuyến có thể đọc được bằng máy đầu ra cần có bản dựng CLI gần đây. Trình cài đặt sẽ tìm nạp phiên bản mới nhất và CLI tự cập nhật khi sử dụng nên bản cài đặt mới sẽ đáp ứng được điều này.

công cụ

Mỗi phát hiện là một MacroscopeIssue với issue_id, sequence, path, line, severity, categoryvà body. Mặc định của khả năng hướng dẫn yêu cầu agent coi mọi phát hiện là không đáng tin cậy: đọc mã bị ảnh hưởng để xác nhận sự cố là có thật, bỏ qua các kết quả dương tính giả và trùng lặp và xác minh từng bản sửa lỗi.

Tùy chọn

Mỗi lĩnh vực của Macroscope với mặc định của nó:

from pydantic_ai_harness import Macroscope

Macroscope(
    base=None,             # git ref to diff against -- None lets the CLI auto-detect
    command='macroscope',  # binary name or path
    cwd='.',               # repository directory the review runs in
    timeout=600.0,         # max seconds to wait for a review
    guidance=None,         # None = default instructions, '' = none, str = custom
)

Mỗi cuộc gọi base đối số được ưu tiên hơn trường. Đánh giá gọi một dịch vụ từ xa, do đó thời gian chờ mặc định là rộng rãi; khi hết thời gian CLI nhóm quy trình bị hủy và thời gian chờ được báo cáo cho mô hình dưới dạng lỗi có thể thử lại.

Phạm vi và thành phần

Khả năng này chỉ hiển thị những phát hiện. Nó không chỉnh sửa tập tin, tạo sơ đồ công việc hoặc cam kết -- xác thực và sửa chữa các phát hiện là công việc của agent, sử dụng các khả năng khác của nó. Ghép nối nó với FileSystem hoặc Shell để cho agent đọc mã và áp dụng các bản sửa lỗi, đồng thời xem xét việc chạy agent ở một nơi riêng biệt Worktree nếu bạn muốn tránh xa cây làm việc của mình.

Thông số agent

Macroscope hoạt động với thông số agent của Pydantic AI, vì vậy bạn có thể khai báo nó trong tệp cấu hình thay vì Python:

# agent.yaml
model: anthropic:claude-sonnet-5
capabilities:
  - Macroscope:
      base: main
      timeout: 900

from pydantic_ai import Agent
from pydantic_ai_harness import Macroscope

agent = Agent.from_file('agent.yaml', custom_capability_types=[Macroscope])

Vượt qua custom_capability_types để trình tải thông số kỹ thuật biết cách khởi tạo Macroscope.

Đọc thêm

• Tài liệu CLI về kính hiển vi
• Khả năng AI của Pydantic
• Bộ công cụ

Tham chiếu API

::: pydantic_ai_harness.macrscope.Macrscope

::: pydantic_ai_harness.macrscope.MacrscopeReview

::: pydantic_ai_harness.macrscope.MacrscopeIssue