> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tích hợp và tham chiếu

> Kết nối các harness agent được hỗ trợ, SDK, CLI và HTTP API.

Chọn tích hợp phù hợp nhất với nơi agent của bạn đã chạy.

<Columns cols={2}>
  <Card title="Agent harnesses" icon="plug-zap" href="/vi/reference/harnesses">
    Cài đặt hook cho các CLI agent coding và autonomous được hỗ trợ.
  </Card>

  <Card title="Custom agents" icon="python" href="/vi/reference/python-sdk">
    Instrumentation traces để tìm lỗi trong custom agent, sau đó liên hệ với chúng tôi để thêm ngăn chặn vào runtime của bạn.
  </Card>

  <Card title="Local dashboard" icon="monitor-cog" href="/vi/reference/local-dashboard">
    Xem xét các dự án cục bộ, phiên làm việc, hoạt động chính sách và audit ngoại tuyến.
  </Card>

  <Card title="Failproof AI CLI" icon="terminal" href="/vi/reference/failproof-cli">
    Cấu hình ghi lại cục bộ, hook, chính sách, audit, phân phối và trạng thái máy.
  </Card>

  <Card title="Failproof Cloud CLI" icon="cloud-cog" href="/vi/reference/cloud-cli#cli-commands">
    Truy vấn và quản trị các phiên Cloud, audit, vấn đề, cảnh báo, khóa, người dùng và cài đặt.
  </Card>

  <Card title="Evaluator SDK" icon="gauge" href="/vi/reference/evaluator-sdk">
    Đánh giá các phiên hoàn chỉnh hoặc không hoạt động với dịch vụ FastAPI.
  </Card>

  <Card title="Custom policies" icon="shield-plus" href="/vi/reference/policy-sdk">
    Tạo và kiểm tra quyết định allow, instruct và deny dành riêng cho quy trình làm việc.
  </Card>

  <Card title="Self-hosting" icon="cloud-cog" href="/vi/reference/self-hosting">
    Triển khai control plane Cloud trên cụm Kubernetes do khách hàng quản lý.
  </Card>
</Columns>

[Tham chiếu HTTP API](/vi/reference/http-api) được tạo bao gồm bề mặt công khai `/v1`. Các trang được viết tay giải thích các quy trình làm việc trải dài nhiều endpoint hoặc sử dụng các giao diện quản trị bên ngoài bề mặt công khai đó.

## Kết nối một agent và xác minh dữ liệu

<Tabs>
  <Tab title="Dashboard">
    1. Mở **Administration → Keys**, tạo khóa với `events:add` và `policies:pull`, và sao chép bí mật.
    2. Cấu hình tích hợp bằng trang phù hợp ở trên.
    3. Mở **Observe → Events** để xác nhận các sự kiện đến, sau đó **Observe → Sessions** để xác nhận chúng tạo thành các lần chạy hoàn chỉnh.
    4. Lọc theo môi trường tích hợp và kiểm tra một phiên làm việc để tìm các trường model, tool, error và policy cần thiết cho audit.

    Bắt đầu với ngăn kéo khóa. Các quyền được chọn xác định xem máy có thể gửi sự kiện và nhận chính sách do Cloud quản lý hay không.

    <img src="https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/key-create.png?fit=max&auto=format&n=WgPwQzedeDNwJBTy&q=85&s=a428bdae79f837471acb66414ff6455b" alt="Ngăn kéo tạo khóa API mới được sử dụng để cấp quyền nhập sự kiện và phân phối chính sách." width="2940" height="1604" data-path="images/dashboard/key-create.png" />

    Sau khi kết nối tích hợp, sử dụng danh sách Sessions để xác nhận rằng các sự kiện của nó được nhóm thành các lần chạy hoàn chỉnh trong môi trường dự kiến.

    <img src="https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/sessions-list.png?fit=max&auto=format&n=WgPwQzedeDNwJBTy&q=85&s=f1fb545746143e87b8b5daedabfc5559" alt="Danh sách Sessions được sử dụng để xác minh rằng tích hợp mới được kết nối đang báo cáo các lần chạy agent hoàn chỉnh." width="3200" height="2000" data-path="images/dashboard/sessions-list.png" />

    Mở một trong các phiên làm việc này trước khi coi tích hợp là hoàn thành; trace phải chứa các bằng chứng model, tool, error và policy mà audit của bạn cần.
  </Tab>

  <Tab title="CLI">
    Tạo khóa máy, kết nối daemon Failproof và xác minh phiên đầu tiên.

    ```bash theme={null}
    fp keys create agent-production \
      --add events:add \
      --add policies:pull

    failproofai config \
      --connect https://app.befailproof.ai \
      --token <machine-key>

    failproofai flush --wait
    fp sessions --since 1h --env production
    fp events --since 1h --env production --limit 20
    ```

    Sử dụng `fp --json sessions ...` khi một công cụ khác sẽ tiêu thụ kết quả. Các cờ toàn cục như `--json`, `--org` và `--base-url` phải đặt trước lệnh.

    Xem [tham chiếu Failproof AI CLI](/vi/reference/failproof-cli) để biết các lệnh cục bộ và [tham chiếu Failproof Cloud CLI](/vi/reference/cloud-cli#cli-commands) để biết các lệnh `fp`.
  </Tab>
</Tabs>