Bắt Đầu với AgentEye

​

AgentEye là gì?

• Các sự kiện — đường dẫu thô, từng bước của mỗi lần chạy agent (các lệnh gọi công cụ, lệnh gọi mô hình, hook, lỗi).
• Các phiên — những sự kiện đó được tập hợp thành một hàng cho mỗi lần chạy, mỗi cái được tự động đánh giá và chấm điểm.
• Các đánh giá — điểm chất lượng được tạo ra bởi các dịch vụ đánh giá của riêng bạn, vì vậy những sự suy giảm chất lượng sẽ được phát hiện mà không cần kiểm tra thủ công.
• Các truy vấn và bảng điều khiển — SQL ClickHouse đã lưu trên dữ liệu của bạn, được vẽ thành các bảng điều khiển được chia sẻ và được phạm vi tổ chức.
• Cảnh báo và sự cố — các quy tắc ngưỡng sẽ gửi thông báo cho bạn (email, Slack, webhook, trong bảng điều khiển) cộng với quy trình làm việc sự cố để phân loại chúng.
• CLI và trợ lý AI — một ứng dụng khách terminal (agenteye) và một trợ lý trong bảng điều khiển để đặt câu hỏi bằng tiếng Anh thuần.

​

Bước 1: Xác thực

export AGENTEYE_TOKEN=<your-github-pat>

# Authenticate Docker against GHCR
echo $AGENTEYE_TOKEN | docker login ghcr.io -u x --password-stdin

​

Bước 2: Triển khai Máy chủ và Bảng điều khiển

mkdir -p ./agenteye
curl -fsSL \
  -H "Authorization: token $AGENTEYE_TOKEN" \
  https://raw.githubusercontent.com/agenteye-enterprise/releases/main/docker-compose.yml \
  -o ./agenteye/docker-compose.yml
cd agenteye

POSTGRES_PASSWORD=your-db-password
ADMIN_KEY=your-admin-secret

docker compose up -d

​

Bước 3: Tạo một Khóa API cho Trình thu thập

curl -s -X POST http://localhost:8080/keys \
  -H "Authorization: Bearer $ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"prod-collector","key":"your-collector-secret","permissions":["events:add"]}'

​

Bước 4: Cài đặt Trình thu thập

VERSION=0.0.1-beta.13
GITHUB_TOKEN=$AGENTEYE_TOKEN gh release download "collector/v${VERSION}" \
  --repo agenteye-enterprise/releases \
  --pattern 'agenteye-collector-linux-x86_64'
chmod +x agenteye-collector-linux-x86_64
sudo mv agenteye-collector-linux-x86_64 /usr/local/bin/agenteye-collector

Điều này tải xuống bản dựng Linux x86_64. Để sử dụng macOS (Apple Silicon hoặc Intel), Linux arm64, hoặc thiết lập Docker / systemd / launchd, xem collector-installation.md, liệt kê bản tải xuống cho mỗi nền tảng — lệnh trên cài đặt một nhị phân Linux sẽ không chạy ở nơi khác.

mkdir -p ~/.agenteye
cat > ~/.agenteye/config.json <<EOF
{
  "url": "http://your-server-host:8080/events",
  "key": "the-key-from-step-3"
}
EOF

agenteye-collector start

agenteye-collector flush

​

Bước 5: Cài đặt Python SDK

VERSION=0.0.1b9
GITHUB_TOKEN=$AGENTEYE_TOKEN gh release download "python-sdk/v${VERSION}" \
  --repo agenteye-enterprise/releases \
  --pattern 'agenteye-*.whl'
pip install agenteye-${VERSION}-py3-none-any.whl

​

Bước 6: Thêm công cụ theo dõi vào Agent của bạn

import agenteye

agenteye.event.agent_start(
    session_id="run-001",
    agent_id="my-agent",
    goal="answer the user query",
)

# your agent logic here

agenteye.event.agent_end(
    session_id="run-001",
    agent_id="my-agent",
    outcome="success",
)

​

Bước 7: Xem các sự kiện trong Bảng điều khiển

​

Bước 8: Khám phá, biểu đồ và cảnh báo

• Queries (/<org>/queries): bắt đầu từ một thư viện các truy vấn đã lưu, có thể tái sử dụng trên các sự kiện và đánh giá của bạn (các cài đặt trước tích hợp cộng với các truy vấn tùy chỉnh của bạn)…

• Dashboards (/<org>/dashboards): ghim các truy vấn như ô đường kẻ, thanh, diện tích hoặc hình tròn vào các bảng điều khiển được chia sẻ, toàn org.

• Alerts (/<org>/alerts): nâng cao bất kỳ ngưỡng nào thành một quy tắc ghi trang thái được thông báo qua email, Slack, webhook hoặc trong bảng điều khiển. Xem enterprise-docs/alerts.md.

​

Các bước tiếp theo

• Deployment: cứng hóa cho production
• API Keys: quản lý quyền truy cập
• Troubleshooting: chẩn đoán các vấn đề