Câu hỏi thường gặp

AgentGIF là gì?

AgentGIF là nền tảng lưu trữ GIF cho nhà phát triển với kiến trúc hai lớp. Mỗi GIF demo terminal được ghép với tệp cast asciinema v2 có thể đọc bằng máy, để cả con người và tác nhân AI đều có thể hiểu nội dung.

Con người nhìn thấy bản ghi terminal hoạt hình. Tác nhân AI thấy dữ liệu có cấu trúc: lệnh, đầu ra, dấu thời gian và metadata.

AgentGIF có miễn phí không?

Có. Tải lên, lưu trữ và nhúng GIF hoàn toàn miễn phí. REST API miễn phí cho các thao tác đọc mà không cần xác thực. Các thao tác ghi (tải lên, chỉnh sửa, xóa) cần API key miễn phí từ trang cài đặt của bạn.

Tệp cast là gì?

Tệp cast là bản ghi asciinema v2. Đây là định dạng văn bản trong đó dòng 1 là header JSON với metadata terminal, theo sau là các tuple sự kiện có dấu thời gian:

{"version": 2, "width": 120, "height": 40}
[0.5, "o", "$ docker compose up -d\r\n"]
[1.2, "o", "Creating network...\r\n"]
[2.8, "o", "Container app-1  Started\r\n"]

Mỗi tuple là [timestamp_seconds, event_type, data]. Điều này cho phép tác nhân AI trích xuất lệnh, đầu ra và thời gian mà không cần OCR.

Làm thế nào để tải lên GIF?

Hai tùy chọn:

• Web: Kéo và thả tại /upload/ (yêu cầu đăng nhập GitHub)
• CLI: agentgif upload demo.gif --title "My Demo" --tags cli,unix

CLI có sẵn cho 5 ngôn ngữ: Python, Node.js, Go, Rust và Ruby. Thêm cờ --cast demo.cast để đính kèm lớp có thể đọc bằng máy.

Làm thế nào để nhúng GIF vào README của tôi?

Mẫu khuyến nghị cho README GitHub:

<p align="center">
  <a href="https://agentgif.com/ID">
    <img src="https://media.agentgif.com/ID.gif" alt="demo" width="800">
  </a>
</p>

Thay ID bằng ID 8 ký tự của GIF. Xem hướng dẫn nhúng đầy đủ cho tất cả 6 phương pháp.

Endpoint .md là gì?

Thêm .md vào bất kỳ URL AgentGIF nào để nhận phản hồi text/markdown được tối ưu hóa cho LLM. Mỗi trang đều hỗ trợ điều này — chi tiết GIF, danh sách thẻ, trang công cụ, bộ sưu tập, hướng dẫn và kết quả tìm kiếm.

curl https://agentgif.com/tools/git/.md
curl https://agentgif.com/explore/tags/docker/.md

Tôi có cần API key không?

Lấy API key miễn phí tại /settings/ sau khi đăng nhập bằng GitHub.

Những theme terminal nào có sẵn?

AgentGIF hỗ trợ tất cả 44 theme terminal VHS. Các lựa chọn phổ biến:

Duyệt tất cả theme với xem trước trực tiếp: Theme Gallery.

Dịch vụ badge là gì?

AgentGIF cung cấp badge gói theo theme terminal như một giải pháp thay thế shields.io. Chúng hiển thị với màu sắc theme terminal bạn chọn.

![PyPI](https://agentgif.com/badge/pypi/requests/version.svg?theme=dracula)
![npm](https://agentgif.com/badge/npm/express/version.svg?theme=nord)
![Stars](https://agentgif.com/badge/github/torvalds/linux/stars.svg)

Nhà cung cấp được hỗ trợ: PyPI, npm, crates.io, GitHub. Tùy chỉnh với tham số ?theme= và ?style=. Xem badge playground.

Tác nhân AI đọc GIF như thế nào?

Tác nhân AI có thể truy cập nội dung GIF qua nhiều kênh:

• Tệp cast: GET /api/v1/gifs/{id}/cast/ — bản ghi asciinema v2 đầy đủ với dấu thời gian
• Bản ghi chép: GET /api/v1/gifs/{id}/transcript/ — văn bản thuần sạch, đã xóa mã ANSI
• endpoint .md: Thêm .md vào bất kỳ URL trang nào để nhận đầu ra Markdown
• JSON API: /api/v1/search/?q=docker — tìm kiếm toàn văn với kết quả có cấu trúc
• llms.txt: /llms.txt — tóm tắt cấp trang web cho trình thu thập AI

Xem đầy đủ tài liệu tích hợp tác nhân AI.

Những định dạng tệp nào được hỗ trợ?

Để có kết quả tốt nhất, giữ GIF dưới 5 MB. Xem hướng dẫn ghi hình để biết mẹo tối ưu hóa.

Làm thế nào để ghi GIF terminal?

Chúng tôi khuyến nghị VHS by Charm cho các bản ghi theo script, tái tạo được:

# Install VHS
brew install vhs

# Create a tape file (demo.tape)
Output demo.gif
Set Theme "Catppuccin Mocha"
Type "echo 'Hello, world!'"
Enter
Sleep 2s

# Record
vhs demo.tape

Hướng dẫn đầy đủ từng bước: Cách ghi GIF Terminal.