Lewati ke konten utama

PDF4me Keterampilan Agen: Memulai

PDF4me Keterampilan Agen adalah paket keterampilan yang dapat diinstal dari publik. pdf4me-skills repositori pada GitHubMereka mengajar AI asisten pengkodean cara menggunakan PDF4me REST API: titik akhir yang benar, bentuk muatan, header otentikasi, dan perutean fitur di seluruh konversi, penggabungan, pemisahan, OCR, ekstrak, hasilkan, Excel, Word, citra, bentuk, dan operasi keamanan.

Ini adalah pisahkan permukaan produk dari PDF4me MCP. MCP menghubungkan ke server alat langsung (uvx pdf4me-mcp) sehingga klien dapat memanggil PDF4me Tindakan sebagai alat bantu selama obrolan. Beban Keterampilan Agen terstruktur API panduan ke dalam agen agar dapat menulis dan menjalankan REST API Kode dengan benar.

PDF4me Keterampilan AgenPDF4me MCP
Apa ituPaket keterampilan dengan API aturan referensi dan peruteanMCP server yang mengekspos PDF4me sebagai alat yang dapat dipanggil
Memasangnpx skills add … atau Claude Code /plugin perintahuvx pdf4me-mcp di klien MCP konfigurasi
Terbaik untukAgen yang menulis skrip, curl, atau kode aplikasi terhadap REST APIAgen yang memanggil alat secara langsung dari obrolan UI
Repositorigithub.com/pdf4me/pdf4me-skillsgithub.com/pdf4me/pdf4me-mcp

Prasyarat

  • A PDF4me akun dan API kunci
  • Akses ke PDF4me REST API pada https://api.pdf4me.com
  • Satu mendukung AI klien (lihat jalur instalasi di bawah)

Kapal apa saja yang ada di repositori?

Keterampilan pertama yang dipublikasikan adalah pdf4me-apiHal ini mengikuti Keterampilan Agen format:

JalurTujuan
skills/pdf4me-api/SKILL.mdKemampuan terwujud, kapan harus menggunakannya, dan API perutean kategori
skills/pdf4me-api/references/Catatan titik akhir dikelompokkan berdasarkan fitur (konversi, edit, ekstrak, hasilkan, …)
skills/pdf4me-api/examples/Contoh skrip sederhana untuk alur kerja umum.

Ketika pengguna meminta untuk mengkonversi PDFgabungkan file, jalankan OCR, isi formulir, atau hubungi siapa saja PDF4me Pada titik akhir, agen harus memuat keterampilan ini dan mengikuti file referensi untuk kategori yang sesuai.

Pilih jalur instalasi Anda

Gunakan jalur ini saat Anda bekerja di Claude Code (berbasis terminal) Claude agen pengkodean). Instalasi menggunakan Claudeperintah plugin bawaan, bukan npx skills.

Langkah 1: Tambahkan PDF4me pasar keterampilan

Di direktori proyek Anda, jalankan:

/plugin marketplace add pdf4me/pdf4me-skills
Terminal Claude Code dengan perintah /plugin marketplace add pdf4me/pdf4me-skills yang diketik pada prompt.

Tambahkan marketplace pdf4me-skills dari GitHub.

Setelah pendaftaran marketplace berhasil, Claude Code menegaskan:

Successfully added marketplace: pdf4me-skills
Claude Code menunjukkan bahwa marketplace pdf4me-skills berhasil ditambahkan setelah perintah penambahan marketplace.

Konfirmasi bahwa marketplace telah ditambahkan.

Langkah 2: Instal plugin pdf4me-api

Mulai perintah instalasi. Anda dapat mengetik /plugin install pdf lalu pilih yang cocok dari fitur pelengkapan otomatis:

/plugin install pdf4me-api@pdf4me-skills
Fitur pelengkapan otomatis Claude Code menampilkan pdf4me-api@pdf4me-skills dengan deskripsi tentang keahlian REST API PDF4me.

Pilih pdf4me-api@pdf4me-skills dari daftar plugin.

Claude Code Menampilkan detail plugin dan meminta lingkup instalasi:

  1. Instalasi untuk Anda (cakupan pengguna): tersedia di semua proyek Anda
  2. Instal untuk semua kolaborator di repositori ini (lingkup proyek): dibagikan melalui konfigurasi repo
  3. Instalasi untuk Anda, hanya di repositori ini (cakupan lokal)hanya kasir ini

Pilih cakupan yang sesuai dengan cara kerja Anda. Untuk lingkungan uji coba pribadi, lingkup lokal atau lingkup pengguna adalah hal yang umum.

Layar instalasi plugin Claude Code untuk pdf4me-api dengan opsi cakupan user, project, dan local.

Pilih cakupan pengguna, proyek, atau instalasi lokal.

Langkah 3: Muat ulang plugin

Setelah instalasi selesai:

✓ Installed pdf4me-skills. Run /reload-plugins to apply.

Berlari:

/reload-plugins
Claude Code menunjukkan instalasi pdf4me-skills yang berhasil dan perintah untuk menjalankan reload-plugins.

Muat ulang plugin agar Claude Code dapat menggunakan skill baru tersebut.

Skill tersebut kini aktif di Claude Code untuk lingkup ini.

Berikan milik Anda API kunci agen

Dokumen keterampilan Bagaimana untuk mengautentikasi (Authorization: Basic <your_api_key>) tetapi tidak menyimpan rahasia. Saat agen menghasilkan kode atau perintah curl, berikan kunci Anda dengan aman:

  • Ekspor PDF4ME_API_KEY (atau tempelkan kuncinya saat agen meminta konfigurasi runtime)
  • Jangan pernah berkomitmen API kunci untuk git

Melihat Terhubung ke PDF4me V2 API untuk format otorisasi dan permintaan lengkap.

Contoh pesan yang muncul setelah instalasi

Setelah skill terpasang, coba perintah seperti:

  • "Menggunakan PDF4me untuk menggabungkan keduanya PDFs dan mengembalikan output base64."
  • "Konversikan ini" Word templat untuk PDF dengan endpoint pembuatan dokumen."
  • "Ekstrak data tabel dari ini" PDF dengan PDF4me."
  • "Yang PDF4me Endpoint apa yang harus saya gunakan untuk menambahkan? QR Code ke sebuah PDF?"

Agen harus memuat pdf4me-api, pilih file referensi yang tepat (misalnya references/merge-split.md atau references/barcode.md), dan menghasilkan yang valid REST panggilan.

Penyelesaian Masalah

Skill tersebut tidak muncul di agen saya.
  • Claude Code: Berlari /reload-plugins Setelah instalasi. Konfirmasikan bahwa Anda telah memilih cakupan yang benar (pengguna, proyek, atau lokal).
  • Keterampilan npx: Jalankan kembali perintah instalasi dan verifikasi apakah agen Anda telah dipilih. Periksa bahwa .agents/skills/pdf4me-api/SKILL.md ada di proyek Anda.
  • Mulai ulang IDE atau sesi agen setelah instalasi pertama.
Claude Code vs npx skills: mana yang sebaiknya saya gunakan?
  • Claude Code hanya: Gunakan /plugin marketplace jalur di Claude Code tab di atas.
  • Cursor, Copilot, Codex, Cline, atau beberapa agen: Menggunakan npx skills add … bahkan jika Claude Code adalah salah satu agen yang terpilih.
Apa perbedaannya dengan PDF4me MCP?

MCP kabel listrik PDF4me server alat ke klien yang mendukung Protokol Konteks Model. Keterampilan Agen mengajar REST API Penggunaan di dalam agen yang mendukung format keterampilan. Anda dapat menggunakan keduanya: MCP untuk panggilan alat dalam obrolan, Keterampilan untuk pembuatan kode dan pembuatan skrip.

Langkah selanjutnya

  • Jelajahi PDF4me API referensi untuk detail titik akhir, poin keterampilan untuk
  • Siapkan PDF4me MCP jika Anda ingin memanggil alat secara langsung MCP klien
  • Bintang atau garpu pdf4me-skills pada GitHub untuk pembaruan dan keterampilan baru