Gemini Agents API

عامل‌ها سیستم‌هایی هستند که از مدل‌های Gemini، مجموعه‌ای از ابزارها و قابلیت‌های استدلال برای انجام وظایف پیچیده و چند مرحله‌ای و دستیابی به اهداف خاص بهره می‌برند. برخلاف یک فراخوانی مدل واحد، یک عامل می‌تواند برنامه‌ریزی کند، مجموعه‌ای از اقدامات را اجرا کند، با سیستم‌های خارجی تعامل داشته باشد و اطلاعات را برای انجام درخواست کاربر ترکیب کند.

مشاهده به صورت markdown مشاهده مشخصات OpenAPI

ایجادعامل

ارسال به آدرس https://generativelanguage.googleapis.com/v1beta/agents

یک عامل جدید (نسخه تایپ شده برای SDK) ایجاد می‌کند.

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

پیکربندی agent_config آنتی‌گراویتی‌ایجنت‌کانفیگ (اختیاری)

پارامترهای پیکربندی برای عامل

پیکربندی برای زمان اجرای عامل Antigravity. کنترل سمت سرور بر محیط اجرای عامل و پیکربندی ابزار را فراهم می‌کند.

فیلدها

رشته‌ی max_total_tokens (اختیاری)

حداکثر مجموع توکن‌ها برای اجرای عامل.

رشته مدل (اختیاری)

مدلی که برای استدلال عامل استفاده می‌شود.

نوع شیء (اختیاری)

هیچ توضیحی ارائه نشده است.

همیشه روی "antigravity" تنظیم شود.

رشته base_agent (اختیاری)

عامل پایه برای گسترش.

رشته یا مقدار رشته‌ای از نوع EnvironmentConfig (اختیاری)

پیکربندی محیط برای عامل.

پیکربندی برای یک محیط سفارشی.

فیلدها

رشته‌ی environment_id (اختیاری)

اختیاری. شناسه محیط برای تعامل. در صورت مشخص شدن، درخواست به جای ایجاد یک محیط جدید، محیط موجود را به‌روزرسانی می‌کند.

شبکه EnvironmentNetworkEgressAllowlist یا enum (رشته‌ای) (اختیاری)

پیکربندی شبکه برای محیط.

پیکربندی شبکه خروجی برای sandbox. یک شیء با آرایه 'allowlist' را برای محدود کردن ترافیک یا رشته 'disabled' را برای خاموش کردن تمام دسترسی به شبکه می‌پذیرد. برای مجاز کردن تمام ترافیک خروجی بدون تزریق هدر، این بخش را به طور کامل حذف کنید.

انواع ممکن

شیء

پیکربندی شبکه خروجی برای sandbox. در صورت مشخص شدن، دامنه‌های خارجی که sandbox می‌تواند به آنها دسترسی داشته باشد را محدود می‌کند. برای مجاز کردن تمام ترافیک خروجی بدون تزریق هدر، این مورد را به طور کامل حذف کنید.

آرایه allowlist (AllowlistEntry) (اختیاری)

فهرست دامنه‌های خروجی مجاز. فقط درخواست‌ها به دامنه‌های فهرست‌شده مجاز هستند. از [{'domain': '*'}] برای مجاز کردن همه دامنه‌ها استفاده کنید و در عین حال هدرها را روی دامنه‌های خاص تزریق کنید.

یک قانون لیست مجاز دامنه واحد با تزریق هدر اختیاری.

فیلدها

رشته دامنه (اختیاری)

دامنه‌ای که درخواست‌های خروجی به آن مجاز است. از کاراکترهای عمومی (مثلاً '*.googleapis.com') پشتیبانی می‌کند. از '*' برای مجاز کردن همه دامنه‌ها استفاده کنید.

تبدیل آرایه (شیء) یا شیء (اختیاری)

هدرهایی برای تزریق در تمام درخواست‌های خروجی مطابق با این دامنه. یک dict یا لیستی از dictها را می‌پذیرد. پروکسی خروجی این موارد را به طور خودکار تزریق می‌کند.

رشته

تمام شبکه‌ها را خاموش می‌کند.

مقادیر ممکن

  • disabled

    تمام شبکه‌ها را خاموش می‌کند.

آرایه منابع (منبع) (اختیاری)

هیچ توضیحی ارائه نشده است.

منبعی که باید در محیط نصب شود.

فیلدها

رشته محتوا (اختیاری)

محتوای درون‌خطی اگر `type` باشد، `INLINE` است.

رشته کدگذاری (اختیاری)

کدگذاری اختیاری برای محتوای درون‌خطی (مثلاً `base64`).

رشته منبع (اختیاری)

منبع محیط. برای فضای ذخیره‌سازی ابری، این مسیر فضای ذخیره‌سازی ابری است. برای گیت‌هاب، این مسیر گیت‌هاب است.

رشته هدف (اختیاری)

جایی که منبع باید در محیط ظاهر شود.

نوع enum (رشته) (اختیاری)

هیچ توضیحی ارائه نشده است.

مقادیر ممکن:

  • gcs

    یک مخزن ذخیره‌سازی ابری.

  • inline

    محتوای درون خطی.

  • repository

    یک مخزن عمومی. پیشوند پروتکل در URL منبع، ارائه‌دهنده را مشخص می‌کند (مثلاً github://، gcs://).

  • skill_registry

    یک منبع مهارت از سرویس ثبت مهارت. مهارت: projects/{project}/locations/{location}/skills/{skill} SkillRevision: projects/{project}/locations/{location}/skills/{skill}/revisions/{revision} پشتیبانی از نصب همه مهارت‌ها تحت یک پروژه: projects/{project}/locations/{location}/skills.

نوع شیء (اختیاری)

هیچ توضیحی ارائه نشده است.

همیشه روی "remote" تنظیم شود.

رشته توضیحات (اختیاری)

توضیحات عامل برای توسعه‌دهندگان تا به سرعت آن را بخوانند و درک کنند.

رشته شناسه (اختیاری)

شناسه منحصر به فرد برای عامل.

رشته system_instruction (اختیاری)

دستورالعمل سیستم برای عامل.

آرایه ابزارها (AgentTool) (اختیاری)

ابزارهایی که در اختیار نماینده قرار دارد.

ابزاری که عامل می‌تواند از آن استفاده کند.

انواع ممکن

اجرای کد

ابزاری که می‌تواند توسط مدل برای اجرای کد استفاده شود.

نوع شیء (الزامی)

هیچ توضیحی ارائه نشده است.

همیشه روی "code_execution" تنظیم شود.

عملکرد

ابزاری که می‌تواند توسط مدل مورد استفاده قرار گیرد.

رشته توضیحات (اختیاری)

شرحی از تابع.

رشته نام (اختیاری)

نام تابع.

پارامتر شیء (اختیاری)

طرحواره JSON برای پارامترهای تابع.

نوع شیء (الزامی)

هیچ توضیحی ارائه نشده است.

همیشه روی "function" تنظیم شود.

جستجوی گوگل

ابزاری که می‌تواند توسط مدل برای جستجو در گوگل استفاده شود.

آرایه search_types (enum (رشته)) (اختیاری)

انواع زمینه‌سازی جستجو برای فعال‌سازی.

مقادیر ممکن:

  • web_search

    تنظیم این فیلد، جستجوی وب را فعال می‌کند. فقط نتایج متنی برگردانده می‌شوند.

  • image_search

    تنظیم این فیلد، جستجوی تصویر را فعال می‌کند. بایت‌های تصویر برگردانده می‌شوند.

  • enterprise_web_search

    تنظیم این فیلد، جستجوی وب سازمانی را فعال می‌کند.

نوع شیء (الزامی)

هیچ توضیحی ارائه نشده است.

همیشه روی "google_search" تنظیم شود.

مک‌پ‌سرور

MCPServer سروری است که می‌تواند توسط مدل برای انجام اقدامات فراخوانی شود.

آرایه allowed_tools (AllowedTools) (اختیاری)

ابزارهای مجاز.

پیکربندی ابزارهای مجاز.

فیلدها

حالت شمارشی (رشته) (اختیاری)

حالت انتخاب ابزار.

مقادیر ممکن:

  • auto

    انتخاب خودکار ابزار.

  • any

    هر انتخاب ابزاری.

  • none

    بدون انتخاب ابزار.

  • validated

    انتخاب ابزار معتبر.

آرایه ابزار (رشته) (اختیاری)

نام ابزارهای مجاز

شیء هدر (اختیاری)

اختیاری: در صورت نیاز، فیلدهایی برای هدرهای احراز هویت، زمان‌های انقضا و غیره.

رشته نام (اختیاری)

نام سرور MCP.

نوع شیء (الزامی)

هیچ توضیحی ارائه نشده است.

همیشه روی "mcp_server" تنظیم شود.

رشته آدرس اینترنتی (اختیاری)

آدرس کامل URL برای نقطه پایانی MCPServer. مثال: "https://api.example.com/mcp"

متن آدرس

ابزاری که می‌تواند توسط مدل برای دریافت متن URL استفاده شود.

نوع شیء (الزامی)

هیچ توضیحی ارائه نشده است.

همیشه روی "url_context" تنظیم شود.

پاسخ

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

پیکربندی agent_config آنتی‌گراویتی‌ایجنت‌کانفیگ (اختیاری)

پارامترهای پیکربندی برای عامل

پیکربندی برای زمان اجرای عامل Antigravity. کنترل سمت سرور بر محیط اجرای عامل و پیکربندی ابزار را فراهم می‌کند.

فیلدها

رشته‌ی max_total_tokens (اختیاری)

حداکثر مجموع توکن‌ها برای اجرای عامل.

رشته مدل (اختیاری)

مدلی که برای استدلال عامل استفاده می‌شود.

نوع شیء (اختیاری)

هیچ توضیحی ارائه نشده است.

همیشه روی "antigravity" تنظیم شود.

رشته base_agent (اختیاری)

عامل پایه برای گسترش.

رشته یا مقدار رشته‌ای از نوع EnvironmentConfig (اختیاری)

پیکربندی محیط برای عامل.

پیکربندی برای یک محیط سفارشی.

فیلدها

رشته‌ی environment_id (اختیاری)

اختیاری. شناسه محیط برای تعامل. در صورت مشخص شدن، درخواست به جای ایجاد یک محیط جدید، محیط موجود را به‌روزرسانی می‌کند.

شبکه EnvironmentNetworkEgressAllowlist یا enum (رشته‌ای) (اختیاری)

پیکربندی شبکه برای محیط.

پیکربندی شبکه خروجی برای sandbox. یک شیء با آرایه 'allowlist' را برای محدود کردن ترافیک یا رشته 'disabled' را برای خاموش کردن تمام دسترسی به شبکه می‌پذیرد. برای مجاز کردن تمام ترافیک خروجی بدون تزریق هدر، این بخش را به طور کامل حذف کنید.

انواع ممکن

شیء

پیکربندی شبکه خروجی برای sandbox. در صورت مشخص شدن، دامنه‌های خارجی که sandbox می‌تواند به آنها دسترسی داشته باشد را محدود می‌کند. برای مجاز کردن تمام ترافیک خروجی بدون تزریق هدر، این مورد را به طور کامل حذف کنید.

آرایه allowlist (AllowlistEntry) (اختیاری)

فهرست دامنه‌های خروجی مجاز. فقط درخواست‌ها به دامنه‌های فهرست‌شده مجاز هستند. از [{'domain': '*'}] برای مجاز کردن همه دامنه‌ها استفاده کنید و در عین حال هدرها را روی دامنه‌های خاص تزریق کنید.

یک قانون لیست مجاز دامنه واحد با تزریق هدر اختیاری.

فیلدها

رشته دامنه (اختیاری)

دامنه‌ای که درخواست‌های خروجی به آن مجاز است. از کاراکترهای عمومی (مثلاً '*.googleapis.com') پشتیبانی می‌کند. از '*' برای مجاز کردن همه دامنه‌ها استفاده کنید.

تبدیل آرایه (شیء) یا شیء (اختیاری)

هدرهایی برای تزریق در تمام درخواست‌های خروجی مطابق با این دامنه. یک dict یا لیستی از dictها را می‌پذیرد. پروکسی خروجی این موارد را به طور خودکار تزریق می‌کند.

رشته

تمام شبکه‌ها را خاموش می‌کند.

مقادیر ممکن

  • disabled

    تمام شبکه‌ها را خاموش می‌کند.

آرایه منابع (منبع) (اختیاری)

هیچ توضیحی ارائه نشده است.

منبعی که باید در محیط نصب شود.

فیلدها

رشته محتوا (اختیاری)

محتوای درون‌خطی اگر `type` باشد، `INLINE` است.

رشته کدگذاری (اختیاری)

کدگذاری اختیاری برای محتوای درون‌خطی (مثلاً `base64`).

رشته منبع (اختیاری)

منبع محیط. برای فضای ذخیره‌سازی ابری، این مسیر فضای ذخیره‌سازی ابری است. برای گیت‌هاب، این مسیر گیت‌هاب است.

رشته هدف (اختیاری)

جایی که منبع باید در محیط ظاهر شود.

نوع enum (رشته) (اختیاری)

هیچ توضیحی ارائه نشده است.

مقادیر ممکن:

  • gcs

    یک مخزن ذخیره‌سازی ابری.

  • inline

    محتوای درون خطی.

  • repository

    یک مخزن عمومی. پیشوند پروتکل در URL منبع، ارائه‌دهنده را مشخص می‌کند (مثلاً github://، gcs://).

  • skill_registry

    یک منبع مهارت از سرویس ثبت مهارت. مهارت: projects/{project}/locations/{location}/skills/{skill} SkillRevision: projects/{project}/locations/{location}/skills/{skill}/revisions/{revision} پشتیبانی از نصب همه مهارت‌ها تحت یک پروژه: projects/{project}/locations/{location}/skills.

نوع شیء (اختیاری)

هیچ توضیحی ارائه نشده است.

همیشه روی "remote" تنظیم شود.

رشته توضیحات (اختیاری)

توضیحات عامل برای توسعه‌دهندگان تا به سرعت آن را بخوانند و درک کنند.

رشته شناسه (اختیاری)

شناسه منحصر به فرد برای عامل.

رشته system_instruction (اختیاری)

دستورالعمل سیستم برای عامل.

آرایه ابزارها (AgentTool) (اختیاری)

ابزارهایی که در اختیار نماینده قرار دارد.

ابزاری که عامل می‌تواند از آن استفاده کند.

انواع ممکن

اجرای کد

ابزاری که می‌تواند توسط مدل برای اجرای کد استفاده شود.

نوع شیء (الزامی)

هیچ توضیحی ارائه نشده است.

همیشه روی "code_execution" تنظیم شود.

عملکرد

ابزاری که می‌تواند توسط مدل مورد استفاده قرار گیرد.

رشته توضیحات (اختیاری)

شرحی از تابع.

رشته نام (اختیاری)

نام تابع.

پارامتر شیء (اختیاری)

طرحواره JSON برای پارامترهای تابع.

نوع شیء (الزامی)

هیچ توضیحی ارائه نشده است.

همیشه روی "function" تنظیم شود.

جستجوی گوگل

ابزاری که می‌تواند توسط مدل برای جستجو در گوگل استفاده شود.

آرایه search_types (enum (رشته)) (اختیاری)

انواع زمینه‌سازی جستجو برای فعال‌سازی.

مقادیر ممکن:

  • web_search

    تنظیم این فیلد، جستجوی وب را فعال می‌کند. فقط نتایج متنی برگردانده می‌شوند.

  • image_search

    تنظیم این فیلد، جستجوی تصویر را فعال می‌کند. بایت‌های تصویر برگردانده می‌شوند.

  • enterprise_web_search

    تنظیم این فیلد، جستجوی وب سازمانی را فعال می‌کند.

نوع شیء (الزامی)

هیچ توضیحی ارائه نشده است.

همیشه روی "google_search" تنظیم شود.

مک‌پ‌سرور

MCPServer سروری است که می‌تواند توسط مدل برای انجام اقدامات فراخوانی شود.

آرایه allowed_tools (AllowedTools) (اختیاری)

ابزارهای مجاز.

پیکربندی ابزارهای مجاز.

فیلدها

حالت شمارشی (رشته) (اختیاری)

حالت انتخاب ابزار.

مقادیر ممکن:

  • auto

    انتخاب خودکار ابزار.

  • any

    هر انتخاب ابزاری.

  • none

    بدون انتخاب ابزار.

  • validated

    انتخاب ابزار معتبر.

آرایه ابزار (رشته) (اختیاری)

نام ابزارهای مجاز

شیء هدر (اختیاری)

اختیاری: در صورت نیاز، فیلدهایی برای هدرهای احراز هویت، زمان‌های انقضا و غیره.

رشته نام (اختیاری)

نام سرور MCP.

نوع شیء (الزامی)

هیچ توضیحی ارائه نشده است.

همیشه روی "mcp_server" تنظیم شود.

رشته آدرس اینترنتی (اختیاری)

آدرس کامل URL برای نقطه پایانی MCPServer. مثال: "https://api.example.com/mcp"

متن آدرس

ابزاری که می‌تواند توسط مدل برای دریافت متن URL استفاده شود.

نوع شیء (الزامی)

هیچ توضیحی ارائه نشده است.

همیشه روی "url_context" تنظیم شود.

ایجاد عامل

پاسخ نمونه 

{
  "created": "2025-11-26T12:25:15Z",
  "display_name": "My Research Agent",
  "id": "ag_abc123",
  "object": "agent",
  "system_instruction": "You are a helpful research assistant.",
  "tools": [
    {
      "type": "google_search"
    }
  ],
  "updated": "2025-11-26T12:25:15Z"
}

نماینده با منابع

پاسخ نمونه 

{
  "created": "2025-11-26T12:25:15Z",
  "id": "data-analyst-abc123",
  "object": "agent",
  "system_instruction": "You are a data analyst. Always include visualizations and export results as PDF.",
  "updated": "2025-11-26T12:25:15Z"
}

عامل از محیط جدا شده است

پاسخ نمونه 

{
  "created": "2025-11-26T12:25:15Z",
  "id": "my-data-analyst",
  "object": "agent",
  "system_instruction": "You are a data analyst. Use the template at /workspace/template.py for all reports.",
  "updated": "2025-11-26T12:25:15Z"
}

لیست ایجنت‌ها

دریافت کنید https://generativelanguage.googleapis.com/v1beta/agents

همه نمایندگان را فهرست می‌کند.

پارامترهای مسیر/پرس‌وجو

عدد صحیح page_size (اختیاری)

هیچ توضیحی ارائه نشده است.

رشته‌ی page_token (اختیاری)

هیچ توضیحی ارائه نشده است.

رشته والد (اختیاری)

هیچ توضیحی ارائه نشده است.

پاسخ

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

آرایه عامل‌ها ( عامل ) (اختیاری)

هیچ توضیحی ارائه نشده است.

رشته‌ی next_page_token (اختیاری)

هیچ توضیحی ارائه نشده است.

لیست نمایندگان

پاسخ نمونه 

{
  "data": [
    {
      "created": "2025-11-26T12:25:15Z",
      "display_name": "My Research Agent",
      "id": "ag_abc123",
      "object": "agent",
      "system_instruction": "You are a helpful research assistant.",
      "updated": "2025-11-26T12:25:15Z"
    }
  ],
  "object": "list"
}

دریافت عامل

دریافت کنید https://generativelanguage.googleapis.com/v1beta/agents/{id}

یک نماینده خاص دریافت می‌کند.

پارامترهای مسیر/پرس‌وجو

رشته شناسه (الزامی)

هیچ توضیحی ارائه نشده است.

پاسخ

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

پیکربندی agent_config آنتی‌گراویتی‌ایجنت‌کانفیگ (اختیاری)

پارامترهای پیکربندی برای عامل

پیکربندی برای زمان اجرای عامل Antigravity. کنترل سمت سرور بر محیط اجرای عامل و پیکربندی ابزار را فراهم می‌کند.

فیلدها

رشته‌ی max_total_tokens (اختیاری)

حداکثر مجموع توکن‌ها برای اجرای عامل.

رشته مدل (اختیاری)

مدلی که برای استدلال عامل استفاده می‌شود.

نوع شیء (اختیاری)

هیچ توضیحی ارائه نشده است.

همیشه روی "antigravity" تنظیم شود.

رشته base_agent (اختیاری)

عامل پایه برای گسترش.

رشته یا مقدار رشته‌ای از نوع EnvironmentConfig (اختیاری)

پیکربندی محیط برای عامل.

پیکربندی برای یک محیط سفارشی.

فیلدها

رشته‌ی environment_id (اختیاری)

اختیاری. شناسه محیط برای تعامل. در صورت مشخص شدن، درخواست به جای ایجاد یک محیط جدید، محیط موجود را به‌روزرسانی می‌کند.

شبکه EnvironmentNetworkEgressAllowlist یا enum (رشته‌ای) (اختیاری)

پیکربندی شبکه برای محیط.

پیکربندی شبکه خروجی برای sandbox. یک شیء با آرایه 'allowlist' را برای محدود کردن ترافیک یا رشته 'disabled' را برای خاموش کردن تمام دسترسی به شبکه می‌پذیرد. برای مجاز کردن تمام ترافیک خروجی بدون تزریق هدر، این بخش را به طور کامل حذف کنید.

انواع ممکن

شیء

پیکربندی شبکه خروجی برای sandbox. در صورت مشخص شدن، دامنه‌های خارجی که sandbox می‌تواند به آنها دسترسی داشته باشد را محدود می‌کند. برای مجاز کردن تمام ترافیک خروجی بدون تزریق هدر، این مورد را به طور کامل حذف کنید.

آرایه allowlist (AllowlistEntry) (اختیاری)

فهرست دامنه‌های خروجی مجاز. فقط درخواست‌ها به دامنه‌های فهرست‌شده مجاز هستند. از [{'domain': '*'}] برای مجاز کردن همه دامنه‌ها استفاده کنید و در عین حال هدرها را روی دامنه‌های خاص تزریق کنید.

یک قانون لیست مجاز دامنه واحد با تزریق هدر اختیاری.

فیلدها

رشته دامنه (اختیاری)

دامنه‌ای که درخواست‌های خروجی به آن مجاز است. از کاراکترهای عمومی (مثلاً '*.googleapis.com') پشتیبانی می‌کند. از '*' برای مجاز کردن همه دامنه‌ها استفاده کنید.

تبدیل آرایه (شیء) یا شیء (اختیاری)

هدرهایی برای تزریق در تمام درخواست‌های خروجی مطابق با این دامنه. یک dict یا لیستی از dictها را می‌پذیرد. پروکسی خروجی این موارد را به طور خودکار تزریق می‌کند.

رشته

تمام شبکه‌ها را خاموش می‌کند.

مقادیر ممکن

  • disabled

    تمام شبکه‌ها را خاموش می‌کند.

آرایه منابع (منبع) (اختیاری)

هیچ توضیحی ارائه نشده است.

منبعی که باید در محیط نصب شود.

فیلدها

رشته محتوا (اختیاری)

محتوای درون‌خطی اگر `type` باشد، `INLINE` است.

رشته کدگذاری (اختیاری)

کدگذاری اختیاری برای محتوای درون‌خطی (مثلاً `base64`).

رشته منبع (اختیاری)

منبع محیط. برای فضای ذخیره‌سازی ابری، این مسیر فضای ذخیره‌سازی ابری است. برای گیت‌هاب، این مسیر گیت‌هاب است.

رشته هدف (اختیاری)

جایی که منبع باید در محیط ظاهر شود.

نوع enum (رشته) (اختیاری)

هیچ توضیحی ارائه نشده است.

مقادیر ممکن:

  • gcs

    یک مخزن ذخیره‌سازی ابری.

  • inline

    محتوای درون خطی.

  • repository

    یک مخزن عمومی. پیشوند پروتکل در URL منبع، ارائه‌دهنده را مشخص می‌کند (مثلاً github://، gcs://).

  • skill_registry

    یک منبع مهارت از سرویس ثبت مهارت. مهارت: projects/{project}/locations/{location}/skills/{skill} SkillRevision: projects/{project}/locations/{location}/skills/{skill}/revisions/{revision} پشتیبانی از نصب همه مهارت‌ها تحت یک پروژه: projects/{project}/locations/{location}/skills.

نوع شیء (اختیاری)

هیچ توضیحی ارائه نشده است.

همیشه روی "remote" تنظیم شود.

رشته توضیحات (اختیاری)

توضیحات عامل برای توسعه‌دهندگان تا به سرعت آن را بخوانند و درک کنند.

رشته شناسه (اختیاری)

شناسه منحصر به فرد برای عامل.

رشته system_instruction (اختیاری)

دستورالعمل سیستم برای عامل.

آرایه ابزارها (AgentTool) (اختیاری)

ابزارهایی که در اختیار نماینده قرار دارد.

ابزاری که عامل می‌تواند از آن استفاده کند.

انواع ممکن

اجرای کد

ابزاری که می‌تواند توسط مدل برای اجرای کد استفاده شود.

نوع شیء (الزامی)

هیچ توضیحی ارائه نشده است.

همیشه روی "code_execution" تنظیم شود.

عملکرد

ابزاری که می‌تواند توسط مدل مورد استفاده قرار گیرد.

رشته توضیحات (اختیاری)

شرحی از تابع.

رشته نام (اختیاری)

نام تابع.

پارامتر شیء (اختیاری)

طرحواره JSON برای پارامترهای تابع.

نوع شیء (الزامی)

هیچ توضیحی ارائه نشده است.

همیشه روی "function" تنظیم شود.

جستجوی گوگل

ابزاری که می‌تواند توسط مدل برای جستجو در گوگل استفاده شود.

آرایه search_types (enum (رشته)) (اختیاری)

انواع زمینه‌سازی جستجو برای فعال‌سازی.

مقادیر ممکن:

  • web_search

    تنظیم این فیلد، جستجوی وب را فعال می‌کند. فقط نتایج متنی برگردانده می‌شوند.

  • image_search

    تنظیم این فیلد، جستجوی تصویر را فعال می‌کند. بایت‌های تصویر برگردانده می‌شوند.

  • enterprise_web_search

    تنظیم این فیلد، جستجوی وب سازمانی را فعال می‌کند.

نوع شیء (الزامی)

هیچ توضیحی ارائه نشده است.

همیشه روی "google_search" تنظیم شود.

مک‌پ‌سرور

MCPServer سروری است که می‌تواند توسط مدل برای انجام اقدامات فراخوانی شود.

آرایه allowed_tools (AllowedTools) (اختیاری)

ابزارهای مجاز.

پیکربندی ابزارهای مجاز.

فیلدها

حالت شمارشی (رشته) (اختیاری)

حالت انتخاب ابزار.

مقادیر ممکن:

  • auto

    انتخاب خودکار ابزار.

  • any

    هر انتخاب ابزاری.

  • none

    بدون انتخاب ابزار.

  • validated

    انتخاب ابزار معتبر.

آرایه ابزار (رشته) (اختیاری)

نام ابزارهای مجاز

شیء هدر (اختیاری)

اختیاری: در صورت نیاز، فیلدهایی برای هدرهای احراز هویت، زمان‌های انقضا و غیره.

رشته نام (اختیاری)

نام سرور MCP.

نوع شیء (الزامی)

هیچ توضیحی ارائه نشده است.

همیشه روی "mcp_server" تنظیم شود.

رشته آدرس اینترنتی (اختیاری)

آدرس کامل URL برای نقطه پایانی MCPServer. مثال: "https://api.example.com/mcp"

متن آدرس

ابزاری که می‌تواند توسط مدل برای دریافت متن URL استفاده شود.

نوع شیء (الزامی)

هیچ توضیحی ارائه نشده است.

همیشه روی "url_context" تنظیم شود.

دریافت نماینده

پاسخ نمونه 

{
  "created": "2025-11-26T12:25:15Z",
  "display_name": "My Research Agent",
  "id": "ag_abc123",
  "object": "agent",
  "system_instruction": "You are a helpful research assistant.",
  "tools": [
    {
      "type": "google_search"
    }
  ],
  "updated": "2025-11-26T12:25:15Z"
}

حذف کننده

https://generativelanguage.googleapis.com/v1beta/agents/{id} را حذف کنید

یک نماینده را حذف می‌کند.

پارامترهای مسیر/پرس‌وجو

رشته شناسه (الزامی)

هیچ توضیحی ارائه نشده است.

پاسخ

در صورت موفقیت، پاسخ خالی است.

حذف عامل

منابع

عامل

تعریف یک عامل برای API CreateAgent. این پیام هدف تجزیه JSON مبتنی بر annotation-parser است. قالب جدید: { "id": "customer-sentinel", "base_agent": "", "system_instruction": "...", "base_environment": { "type": "remote", "sources": [...] }, "tools": [ { "type": "code_execution"} ] }

فیلدها

پیکربندی agent_config آنتی‌گراویتی‌ایجنت‌کانفیگ (اختیاری)

پارامترهای پیکربندی برای عامل

پیکربندی برای زمان اجرای عامل Antigravity. کنترل سمت سرور بر محیط اجرای عامل و پیکربندی ابزار را فراهم می‌کند.

فیلدها

رشته‌ی max_total_tokens (اختیاری)

حداکثر مجموع توکن‌ها برای اجرای عامل.

رشته مدل (اختیاری)

مدلی که برای استدلال عامل استفاده می‌شود.

نوع شیء (اختیاری)

هیچ توضیحی ارائه نشده است.

همیشه روی "antigravity" تنظیم شود.

رشته base_agent (اختیاری)

عامل پایه برای گسترش.

رشته یا مقدار رشته‌ای از نوع EnvironmentConfig (اختیاری)

پیکربندی محیط برای عامل.

پیکربندی برای یک محیط سفارشی.

فیلدها

رشته‌ی environment_id (اختیاری)

اختیاری. شناسه محیط برای تعامل. در صورت مشخص شدن، درخواست به جای ایجاد یک محیط جدید، محیط موجود را به‌روزرسانی می‌کند.

شبکه EnvironmentNetworkEgressAllowlist یا enum (رشته‌ای) (اختیاری)

پیکربندی شبکه برای محیط.

پیکربندی شبکه خروجی برای sandbox. یک شیء با آرایه 'allowlist' را برای محدود کردن ترافیک یا رشته 'disabled' را برای خاموش کردن تمام دسترسی به شبکه می‌پذیرد. برای مجاز کردن تمام ترافیک خروجی بدون تزریق هدر، این بخش را به طور کامل حذف کنید.

انواع ممکن

شیء

پیکربندی شبکه خروجی برای sandbox. در صورت مشخص شدن، دامنه‌های خارجی که sandbox می‌تواند به آنها دسترسی داشته باشد را محدود می‌کند. برای مجاز کردن تمام ترافیک خروجی بدون تزریق هدر، این مورد را به طور کامل حذف کنید.

آرایه allowlist (AllowlistEntry) (اختیاری)

فهرست دامنه‌های خروجی مجاز. فقط درخواست‌ها به دامنه‌های فهرست‌شده مجاز هستند. از [{'domain': '*'}] برای مجاز کردن همه دامنه‌ها استفاده کنید و در عین حال هدرها را روی دامنه‌های خاص تزریق کنید.

یک قانون لیست مجاز دامنه واحد با تزریق هدر اختیاری.

فیلدها

رشته دامنه (اختیاری)

دامنه‌ای که درخواست‌های خروجی به آن مجاز است. از کاراکترهای عمومی (مثلاً '*.googleapis.com') پشتیبانی می‌کند. از '*' برای مجاز کردن همه دامنه‌ها استفاده کنید.

تبدیل آرایه (شیء) یا شیء (اختیاری)

هدرهایی برای تزریق در تمام درخواست‌های خروجی مطابق با این دامنه. یک dict یا لیستی از dictها را می‌پذیرد. پروکسی خروجی این موارد را به طور خودکار تزریق می‌کند.

رشته

تمام شبکه‌ها را خاموش می‌کند.

مقادیر ممکن

  • disabled

    تمام شبکه‌ها را خاموش می‌کند.

آرایه منابع (منبع) (اختیاری)

هیچ توضیحی ارائه نشده است.

منبعی که باید در محیط نصب شود.

فیلدها

رشته محتوا (اختیاری)

محتوای درون‌خطی اگر `type` باشد، `INLINE` است.

رشته کدگذاری (اختیاری)

کدگذاری اختیاری برای محتوای درون‌خطی (مثلاً `base64`).

رشته منبع (اختیاری)

منبع محیط. برای فضای ذخیره‌سازی ابری، این مسیر فضای ذخیره‌سازی ابری است. برای گیت‌هاب، این مسیر گیت‌هاب است.

رشته هدف (اختیاری)

جایی که منبع باید در محیط ظاهر شود.

نوع enum (رشته) (اختیاری)

هیچ توضیحی ارائه نشده است.

مقادیر ممکن:

  • gcs

    یک مخزن ذخیره‌سازی ابری.

  • inline

    محتوای درون خطی.

  • repository

    یک مخزن عمومی. پیشوند پروتکل در URL منبع، ارائه‌دهنده را مشخص می‌کند (مثلاً github://، gcs://).

  • skill_registry

    یک منبع مهارت از سرویس ثبت مهارت. مهارت: projects/{project}/locations/{location}/skills/{skill} SkillRevision: projects/{project}/locations/{location}/skills/{skill}/revisions/{revision} پشتیبانی از نصب همه مهارت‌ها تحت یک پروژه: projects/{project}/locations/{location}/skills.

نوع شیء (اختیاری)

هیچ توضیحی ارائه نشده است.

همیشه روی "remote" تنظیم شود.

رشته توضیحات (اختیاری)

توضیحات عامل برای توسعه‌دهندگان تا به سرعت آن را بخوانند و درک کنند.

رشته شناسه (اختیاری)

شناسه منحصر به فرد برای عامل.

رشته system_instruction (اختیاری)

دستورالعمل سیستم برای عامل.

آرایه ابزارها (AgentTool) (اختیاری)

ابزارهایی که در اختیار نماینده قرار دارد.

ابزاری که عامل می‌تواند از آن استفاده کند.

انواع ممکن

اجرای کد

ابزاری که می‌تواند توسط مدل برای اجرای کد استفاده شود.

نوع شیء (الزامی)

هیچ توضیحی ارائه نشده است.

همیشه روی "code_execution" تنظیم شود.

عملکرد

ابزاری که می‌تواند توسط مدل مورد استفاده قرار گیرد.

رشته توضیحات (اختیاری)

شرحی از تابع.

رشته نام (اختیاری)

نام تابع.

پارامتر شیء (اختیاری)

طرحواره JSON برای پارامترهای تابع.

نوع شیء (الزامی)

هیچ توضیحی ارائه نشده است.

همیشه روی "function" تنظیم شود.

جستجوی گوگل

ابزاری که می‌تواند توسط مدل برای جستجو در گوگل استفاده شود.

آرایه search_types (enum (رشته)) (اختیاری)

انواع زمینه‌سازی جستجو برای فعال‌سازی.

مقادیر ممکن:

  • web_search

    تنظیم این فیلد، جستجوی وب را فعال می‌کند. فقط نتایج متنی برگردانده می‌شوند.

  • image_search

    تنظیم این فیلد، جستجوی تصویر را فعال می‌کند. بایت‌های تصویر برگردانده می‌شوند.

  • enterprise_web_search

    تنظیم این فیلد، جستجوی وب سازمانی را فعال می‌کند.

نوع شیء (الزامی)

هیچ توضیحی ارائه نشده است.

همیشه روی "google_search" تنظیم شود.

مک‌پ‌سرور

MCPServer سروری است که می‌تواند توسط مدل برای انجام اقدامات فراخوانی شود.

آرایه allowed_tools (AllowedTools) (اختیاری)

ابزارهای مجاز.

پیکربندی ابزارهای مجاز.

فیلدها

حالت شمارشی (رشته) (اختیاری)

حالت انتخاب ابزار.

مقادیر ممکن:

  • auto

    انتخاب خودکار ابزار.

  • any

    هر انتخاب ابزاری.

  • none

    بدون انتخاب ابزار.

  • validated

    انتخاب ابزار معتبر.

آرایه ابزار (رشته) (اختیاری)

نام ابزارهای مجاز

شیء هدر (اختیاری)

اختیاری: در صورت نیاز، فیلدهایی برای هدرهای احراز هویت، زمان‌های انقضا و غیره.

رشته نام (اختیاری)

نام سرور MCP.

نوع شیء (الزامی)

هیچ توضیحی ارائه نشده است.

همیشه روی "mcp_server" تنظیم شود.

رشته آدرس اینترنتی (اختیاری)

آدرس کامل URL برای نقطه پایانی MCPServer. مثال: "https://api.example.com/mcp"

متن آدرس

ابزاری که می‌تواند توسط مدل برای دریافت متن URL استفاده شود.

نوع شیء (الزامی)

هیچ توضیحی ارائه نشده است.

همیشه روی "url_context" تنظیم شود.