Autonomous AI Agent Protocol بروتوكول الوكلاء المستقلين
Copyable system prompt, RFC 7807 error handling, and zero-conflict automation standard. بروتوكول موحد للوكلاء الأذكياء ومطوري الأدوات مع تعليمات النظام الجاهزة للنسخ.
Autonomous Agent Integration Standard
Specifications for LangChain, AutoGPT, Claude Computer Use, OpenAI Function Calling, and background daemons.
Vismatix is designed from the ground up for zero-conflict autonomous agent operation. Agents can inspect weekly calendar occupancy across the 84-slot matrix, resolve peak engagement hours, batch-create scheduled content with automatic collision protection, and verify delivery via standard webhooks.
صُممت منصة Vismatix لتكون متوافقة تماماً مع الوكلاء الأذكياء والروبوتات البرمجية المستقلة. يستطيع الوكيل فحص مصفوفة الـ 84 خانة، واكتشاف ساعات الذروة، وجدولة المحتوى بدقة دون أي تضارب، والتحقق من النشر عبر الويب هوك.
Pass Authorization: Bearer <key> along with Accept: application/json on every request. Tokens are cached for 60s to ensure sub-millisecond agent loop latency.
Always attach a unique UUID v4 in Idempotency-Key for all POST, PUT, and PATCH calls to safely retry on network drops.
Any non-2xx status returns a deterministic problem details object with error_code, message, and actionable resolution context.
Recommended Agent System Prompt
Copy & Paste into LLM System InstructionsProvide this instruction prompt to Claude, GPT-4o, Gemini 1.5/2.0, or DeepSeek agents when delegating content calendar management:
You are an Autonomous Social Media Planning Agent with programmatic access to Vismatix API v3 and v2. Base URL: https://vismatix.online/api/v3 (or /api/v3) Core Operating Rules: 1. Always include: - "Authorization: Bearer <API_KEY>" - "Accept: application/json" - "Idempotency-Key: <UUID>" on all mutating POST/PUT/PATCH requests to prevent duplicate posts. 2. The Vismatix calendar operates on a structured 7-day x 12-slot (84 blocks total) weekly matrix. 3. When creating posts via API v3 (POST /api/v3/posts), you can omit "time_block_id" and provide "scheduled_at" as an ISO timestamp — Vismatix auto-resolves the matching agenda block. 4. For high-volume generation, use the atomic batch endpoint: POST /api/v3/posts/batch with up to 50 posts. 5. In case of network errors (HTTP 429 or 5xx), implement exponential backoff with jitter. 6. Handle RFC 7807 structured error codes: - INVALID_IDEMPOTENCY_KEY: Generate a valid UUID v4. - FORBIDDEN_PROJECT_KEY: Key is restricted to project scope; do not attempt account mutations. - RATE_LIMIT_EXCEEDED: Throttle requests according to the "Retry-After" response header.
OpenAI / Claude Tool Definitions (JSON Schema)
tools[] formatPlug these ready-to-use tool declarations into your OpenAI, Anthropic, or LangChain agents:
[
{
"type": "function",
"function": {
"name": "create_vismatix_post",
"description": "Schedule a social media post in Vismatix with automatic peak time-block assignment.",
"parameters": {
"type": "object",
"properties": {
"title": { "type": "string", "description": "Internal working headline or topic." },
"description": { "type": "string", "description": "The actual post copy formatted for social channels." },
"scheduled_at": { "type": "string", "description": "ISO-8601 UTC timestamp (e.g. 2026-10-22T09:00:00Z)." },
"status": { "type": "string", "enum": ["draft", "scheduled"], "default": "draft" }
},
"required": ["title", "description", "scheduled_at"]
}
}
},
{
"type": "function",
"function": {
"name": "get_weekly_matrix",
"description": "Query the 84-slot weekly calendar grid to inspect occupancy and peak engagement slots.",
"parameters": {
"type": "object",
"properties": {
"project_id": { "type": "integer", "description": "Optional workspace ID filter." }
}
}
}
},
{
"type": "function",
"function": {
"name": "audit_virality_score",
"description": "Evaluate copy virality potential on a 0-100 scale analyzing pattern interrupt and hook strength.",
"parameters": {
"type": "object",
"properties": {
"content": { "type": "string", "description": "Post text to score." }
},
"required": ["content"]
}
}
}
]