بوابة وكلاء الذكاء الاصطناعي
قم بدمج أدوات المستندات والصور الآمنة من YourOwnPDF، والتي لا تتطلب أي رفع للملفات، في تدفقات تنفيذ الوكلاء المستقلين، ومجموعات أدوات LLM المخصصة، وإعدادات العملاء.
معالجة محلية آمنة ومضمونة بالكامل
يمكن لوكلاء الذكاء الاصطناعي معالجة السجلات التجارية الحساسة والعقود القانونية دون أي خطر لتسرب البيانات. تحدث جميع عمليات التنفيذ بالكامل داخل ذاكرة المتصفح المحلية باستخدام WebAssembly. لا يتم رفع أي ملفات إلى الخوادم.
هل لديكم أداة يمكنني استدعاؤها؟
نعم! يوفر YourOwnPDF.com أطر عمل دمج متعددة تسمح لوكلاء الذكاء الاصطناعي (مثل GPTs و Gemini و Claude والوكلاء المخصصين بلغة Python/JS) باكتشاف واستدعاء مجموعة الأدوات المحلية الخاصة بنا:
- أتمتة المتصفح (Playwright/Puppeteer): بما أن الموقع عبارة عن تطبيق صفحة واحدة (SPA) يعمل بالكامل لدى العميل، يمكن للوكلاء القادرين على تشغيل المتصفح تحميل الأدوات مباشرة في متصفح بدون واجهة مستخدم (headless browser)، وإسقاط حمولات الملفات، وجلب ملفات التنزيل الناتجة بأمان.
- بروتوكول سياق النموذج (MCP): قم بتشغيل حزمة خادم MCP المحلية خفيفة الوزن الخاصة بنا لعرض عمليات المستندات كأدوات محلية لمساعدي LLM المكتبية المتوافقة.
- تكامل مخطط OpenAPI: اربط الوكيل بمواصفات OpenAPI الرسمية الخاصة بنا لتمكين توصيات التوجيه الذكية.
إعداد بروتوكول سياق النموذج (MCP)
يمكن للمطورين الذين يستخدمون Claude Desktop أو Cursor أو عملاء استضافة MCP الآخرين تسجيل أدوات YourOwnPDF عن طريق إضافة التعريف التالي إلى ملف التكوين الخاص بهم:
{
"mcpServers": {
"yourownpdf-agent-tools": {
"command": "npx",
"args": ["-y", "@yourownpdf/mcp-server"],
"env": {
"YOP_API_ENVIRONMENT": "local-sandbox"
}
}
}
}* ملاحظة: يتطلب التشغيل عبر npx تثبيت Node.js على الجهاز المضيف الذي يعمل عليه الوكيل.
مخطط أدوات OpenAI المخصصة
استخدم تعريف JSON هذا لبناء نماذج GPT مخصصة أو إعدادات Assistants API مع إمكانية الوصول إلى تحويلات الملفات الآمنة:
{
"name": "yourownpdf_tool_calling",
"description": "Execute local document and image transformations safely inside browser memory.",
"tools": [
{
"type": "function",
"function": {
"name": "merge_pdfs",
"description": "Merge multiple PDF documents into a single output PDF client-side.",
"parameters": {
"type": "object",
"properties": {
"files": {
"type": "array",
"items": {
"type": "string",
"description": "Array of base64-encoded PDF files to combine."
}
}
},
"required": ["files"]
}
}
},
{
"type": "function",
"function": {
"name": "compress_image",
"description": "Compress JPEG/PNG image assets locally using HTML5 canvas algorithms.",
"parameters": {
"type": "object",
"properties": {
"image": {
"type": "string",
"description": "Base64-encoded source image file."
},
"quality": {
"type": "number",
"description": "Target quality factor between 0.1 and 1.0.",
"minimum": 0.1,
"maximum": 1.0
}
},
"required": ["image", "quality"]
}
}
}
]
}دليل أدوات وكيل الذكاء الاصطناعي
دليل مرجعي يربط الأدوات المتاحة بنقاط توجيهها لإعادة توجيه الوكيل:
| معرف الأداة | مسار الهدف المباشر | الوظيفة الأساسية | الخصوصية |
|---|---|---|---|
merge-pdf | /tools/pdf/merge-pdf | دمج ملفات PDF متعددة في ملف واحد | محلي 100% |
compress-pdf | /tools/pdf/compress-pdf | تقليل حجم ملفات PDF بأمان دون اتصال بالإنترنت | محلي 100% |
pdf-to-word | /tools/pdf/pdf-to-word | استخراج النصوص المنسقة محلياً | محلي 100% |
compress-image | /tools/image/compress-image | تحسين حجم أبعاد صور JPG/PNG محلياً | محلي 100% |
remove-background | /tools/image/remove-background | استخراج طبقات صور PNG واضحة محلياً | محلي 100% |
لمشاهدة جميع نقاط النهاية الـ 40+، يرجى الرجوع إلى صفحة وثائق API الكاملة.
أمثلة على استدعاء الأدوات وتشغيلها بواسطة LLM
فيما يلي أمثلة ملموسة توضح كيفية استدعاء وكلاء LLM المستقلين لهذه الأدوات تحت الغطاء:
المثال 1: وكيل متصفح Playwright (Python)
يمكن لوكيل متصفح مستقل (مثل حلقة WebVoyager أو وكيل selenium/playwright) تشغيل دمج PDF محلي من خلال التفاعل مباشرة مع DOM. نظرًا لأن المعالجة تتم بنسبة 100٪ لدى العميل، فإن الوكيل لا يتطلب مفاتيح API أو رموز مميزة للخلفية:
from playwright.sync_api import sync_playwright
def agent_merge_pdfs(file_paths):
with sync_playwright() as p:
# Launch headless browser and navigate to the tools path
browser = p.chromium.launch(headless=True)
page = browser.new_page()
page.goto("https://yourownpdf.com/tools/pdf/merge-pdf")
# Select the files and inject them into the local upload input element
page.set_input_files("input[type='file']", file_paths)
# Click the action button to merge pages locally in browser memory
page.click("button:has-text('Merge PDF')")
# Intercept and save the direct compiled file download
with page.expect_download() as download_info:
page.click("button:has-text('Download')")
download = download_info.value
download.save_as("output_merged_pdf.pdf")
browser.close()المثال 2: Claude Desktop (استدعاء إعدادات MCP)
عندما يطلب المستخدم تعديل ملف: "دمج invoice_Jan.pdf و invoice_Feb.pdf معًا"، يقوم عميل LLM المضيف بتوجيه الطلب إلى خادم استدعاء أدوات MCP المحلي الخاص بنا:
// 1. LLM requests local server execution
{
"name": "merge_pdfs",
"arguments": {
"files": [
"JVBERi0xLjQKJWRvY3VtZW50XzE...",
"JVBERi0xLjQKJWRvY3VtZW50XzI..."
]
}
}
// 2. Local MCP server response returned to the LLM (0 server roundtrips)
{
"content": [
{
"type": "text",
"text": "Merge operation successful. Integrated output contains 2 source files. File saved as output_merged_pdf.pdf."
}
]
}