Gemini Agents API

Agjentët janë sisteme që shfrytëzojnë modelet Gemini, një sërë mjetesh dhe aftësi arsyetimi për të kryer detyra komplekse me shumë hapa dhe për të arritur qëllime specifike. Ndryshe nga një thirrje e vetme modeli, një agjent mund të planifikojë, ekzekutojë një sërë veprimesh, të bashkëveprojë me sisteme të jashtme dhe të sintetizojë informacion për të përmbushur kërkesën e një përdoruesi.

Shiko si ulje Shikoni Specifikimin OpenAPI

KrijoAgjent

posto https://generativelanguage.googleapis.com/v1beta/agents

Krijon një Agjent të ri (version i shtypur për SDK).

Trupi i kërkesës

Trupi i kërkesës përmban të dhëna me strukturën e mëposhtme:

agent_config AntigravityAgentConfig (opsionale)

Parametrat e konfigurimit për agjentin.

Konfigurimi për kohën e ekzekutimit të agjentit Antigravity. Ofron kontroll nga ana e serverit mbi mjedisin e ekzekutimit të agjentit dhe konfigurimin e mjetit.

Fushat

vargu max_total_tokens (opsional)

Totali maksimal i tokenëve për ekzekutimin e agjentit.

varg modeli (opsional)

Modeli që do të përdoret për arsyetimin e agjentit.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "antigravity" .

vargu i agjentit_bazë (opsional)

Agjenti bazë për t'u zgjeruar.

base_environment EnvironmentConfig ose varg (opsional)

Konfigurimi i mjedisit për agjentin.

Konfigurimi për një mjedis të personalizuar.

Fushat

vargu environment_id (opsional)

Opsionale. ID-ja e mjedisit për bashkëveprimin. Nëse specifikohet, kërkesa do të përditësojë mjedisin ekzistues në vend që të krijojë një të ri.

network EnvironmentNetworkEgressAllowlist ose enum (string) (opsionale)

Konfigurimi i rrjetit për mjedisin.

Konfigurimi i rrjetit dalës për sandbox-in. Pranon një objekt me një matricë 'allowlist' për të kufizuar trafikun, ose vargun 'disabled' për të çaktivizuar të gjithë aksesin në rrjet. Hiqeni plotësisht për të lejuar të gjithë trafikun dalës pa injektim në kokë.

Llojet e mundshme

objekt

Konfigurimi i rrjetit dalës për sandbox-in. Kur specifikohet, kufizon se cilat domene të jashtme mund të arrijë sandbox-i. Hiqeni plotësisht për të lejuar të gjithë trafikun dalës pa injektim të kokës.

vargu i listës së lejimeve (AllowlistEntry) (opsionale)

Lista e domeneve të lejuara dalëse. Lejohen vetëm kërkesat për domenet e listuara. Përdorni [{'domain': '*'}] për të lejuar të gjitha domenet, ndërkohë që ende injektohen tituj në ato specifike.

Një rregull i listës së lejimeve të një domeni të vetëm me injeksion opsional të kokës.

Fushat

varg domeni (opsional)

Domeni për të lejuar kërkesat dalëse. Mbështet shenjat karakteristike (p.sh. '*.googleapis.com'). Përdorni '*' për të lejuar të gjitha domenet.

transformimi i vargut (objektit) ose objektit (opsional)

Tituj për t'u injektuar në të gjitha kërkesat dalëse që përputhen me këtë domen. Pranon një diktat të vetëm ose një listë diktatesh. Proxy i daljes i injekton këto automatikisht.

varg

Çaktivizon të gjithë rrjetin.

Vlerat e mundshme

  • disabled

    Çaktivizon të gjithë rrjetin.

vargu i burimeve (Burimi) (opsional)

Nuk është dhënë përshkrim.

Një burim që do të montohet në mjedis.

Fushat

varg përmbajtjeje (opsionale)

Përmbajtja brenda rreshtit nëse `tipi` është `INLINE`.

vargu i kodimit (opsional)

Kodim opsional për përmbajtjen brenda rreshtit (p.sh. `base64`).

vargu burimor (opsional)

Burimi i mjedisit. Për Cloud Storage, kjo është shtegu i Cloud Storage. Për GitHub, kjo është shtegu i GitHub.

vargu i synuar (opsional)

Ku duhet të shfaqet burimi në mjedis.

tipi enum (string) (opsionale)

Nuk është dhënë përshkrim.

Vlerat e mundshme:

  • gcs

    Një kovë Ruajtjeje në Cloud.

  • inline

    Përmbajtje e integruar.

  • repository

    Një depo gjenerike. Parashtesa e protokollit në URL-në burimore identifikon ofruesin (p.sh., github://, gcs://).

  • skill_registry

    Një burim aftësish nga Shërbimi i Regjistrit të Aftësive. Aftësi: projects/{project}/locations/{location}/skills/{skill} Rishikimi i Aftësive: projects/{project}/locations/{location}/skills/{skill}/revisions/{revision} Mbështet montimin e të gjitha aftësive në kuadër të një projekti: projects/{project}/locations/{location}/skills.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "remote" .

varg përshkrimi (opsional)

Përshkrimi i agjentit që zhvilluesit ta lexojnë dhe ta kuptojnë shpejt.

vargu i identifikimit (opsional)

Identifikuesi unik për agjentin.

vargu i udhëzimit_të_sistem-it (opsional)

Udhëzime sistemi për agjentin.

grup mjetesh (AgentTool) (opsionale)

Mjetet në dispozicion të agjentit.

Një mjet që agjenti mund ta përdorë.

Llojet e mundshme

Ekzekutimi i Kodit

Një mjet që mund të përdoret nga modeli për të ekzekutuar kodin.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "code_execution" .

Funksioni

Një mjet që mund të përdoret nga modeli.

varg përshkrimi (opsional)

Një përshkrim i funksionit.

varg emri (opsional)

Emri i funksionit.

objekt parametrash (opsional)

Skema JSON për parametrat e funksionit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "function" .

Kërkimi në Google

Një mjet që mund të përdoret nga modeli për të kërkuar në Google.

vargu search_types (enum (string)) (opsional)

Llojet e tokëzimit të kërkimit që duhen aktivizuar.

Vlerat e mundshme:

  • web_search

    Vendosja e kësaj fushe aktivizon kërkimin në internet. Kthehen vetëm rezultatet me tekst.

  • image_search

    Vendosja e kësaj fushe aktivizon kërkimin e imazheve. Kthehen bajtet e imazheve.

  • enterprise_web_search

    Vendosja e kësaj fushe aktivizon kërkimin në internet të ndërmarrjes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "google_search" .

McpServer

Një MCPServer është një server që mund të thirret nga modeli për të kryer veprime.

vargu allowed_tools (AllowedTools) (opsional)

Mjetet e lejuara.

Konfigurimi për mjetet e lejuara.

Fushat

enumimi i modalitetit (vargu) (opsional)

Mënyra e zgjedhjes së mjetit.

Vlerat e mundshme:

  • auto

    Zgjedhja e mjetit automatik.

  • any

    Çdo zgjedhje mjeti.

  • none

    Pa zgjedhje mjetesh.

  • validated

    Zgjedhje e mjetit të validuar.

varg mjetesh (varg) (opsional)

Emrat e mjeteve të lejuara.

objekti i headers (opsional)

Opsionale: Fushat për titujt e vërtetimit, afatet kohore, etj., nëse është e nevojshme.

varg emri (opsional)

Emri i MCPServer-it.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "mcp_server" .

vargu i url- së (opsional)

URL-ja e plotë për pikën fundore të MCPServer. Shembull: "https://api.example.com/mcp"

Konteksti i Url-it

Një mjet që mund të përdoret nga modeli për të marrë kontekstin e URL-së.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "url_context" .

Përgjigje

Nëse është i suksesshëm, trupi i përgjigjes përmban të dhëna me strukturën e mëposhtme:

agent_config AntigravityAgentConfig (opsionale)

Parametrat e konfigurimit për agjentin.

Konfigurimi për kohën e ekzekutimit të agjentit Antigravity. Ofron kontroll nga ana e serverit mbi mjedisin e ekzekutimit të agjentit dhe konfigurimin e mjetit.

Fushat

vargu max_total_tokens (opsional)

Totali maksimal i tokenëve për ekzekutimin e agjentit.

varg modeli (opsional)

Modeli që do të përdoret për arsyetimin e agjentit.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "antigravity" .

vargu i agjentit_bazë (opsional)

Agjenti bazë për t'u zgjeruar.

base_environment EnvironmentConfig ose varg (opsional)

Konfigurimi i mjedisit për agjentin.

Konfigurimi për një mjedis të personalizuar.

Fushat

vargu environment_id (opsional)

Opsionale. ID-ja e mjedisit për bashkëveprimin. Nëse specifikohet, kërkesa do të përditësojë mjedisin ekzistues në vend që të krijojë një të ri.

network EnvironmentNetworkEgressAllowlist ose enum (string) (opsionale)

Konfigurimi i rrjetit për mjedisin.

Konfigurimi i rrjetit dalës për sandbox-in. Pranon një objekt me një matricë 'allowlist' për të kufizuar trafikun, ose vargun 'disabled' për të çaktivizuar të gjithë aksesin në rrjet. Hiqeni plotësisht për të lejuar të gjithë trafikun dalës pa injektim në kokë.

Llojet e mundshme

objekt

Konfigurimi i rrjetit dalës për sandbox-in. Kur specifikohet, kufizon se cilat domene të jashtme mund të arrijë sandbox-i. Hiqeni plotësisht për të lejuar të gjithë trafikun dalës pa injektim të kokës.

vargu i listës së lejimeve (AllowlistEntry) (opsionale)

Lista e domeneve të lejuara dalëse. Lejohen vetëm kërkesat për domenet e listuara. Përdorni [{'domain': '*'}] për të lejuar të gjitha domenet, ndërkohë që ende injektohen tituj në ato specifike.

Një rregull i listës së lejimeve të një domeni të vetëm me injeksion opsional të kokës.

Fushat

varg domeni (opsional)

Domeni për të lejuar kërkesat dalëse. Mbështet shenjat karakteristike (p.sh. '*.googleapis.com'). Përdorni '*' për të lejuar të gjitha domenet.

transformimi i vargut (objektit) ose objektit (opsional)

Tituj për t'u injektuar në të gjitha kërkesat dalëse që përputhen me këtë domen. Pranon një diktat të vetëm ose një listë diktatesh. Proxy i daljes i injekton këto automatikisht.

varg

Çaktivizon të gjithë rrjetin.

Vlerat e mundshme

  • disabled

    Çaktivizon të gjithë rrjetin.

vargu i burimeve (Burimi) (opsional)

Nuk është dhënë përshkrim.

Një burim që do të montohet në mjedis.

Fushat

varg përmbajtjeje (opsionale)

Përmbajtja brenda rreshtit nëse `tipi` është `INLINE`.

vargu i kodimit (opsional)

Kodim opsional për përmbajtjen brenda rreshtit (p.sh. `base64`).

vargu burimor (opsional)

Burimi i mjedisit. Për Cloud Storage, kjo është shtegu i Cloud Storage. Për GitHub, kjo është shtegu i GitHub.

vargu i synuar (opsional)

Ku duhet të shfaqet burimi në mjedis.

tipi enum (string) (opsionale)

Nuk është dhënë përshkrim.

Vlerat e mundshme:

  • gcs

    Një kovë Ruajtjeje në Cloud.

  • inline

    Përmbajtje e integruar.

  • repository

    Një depo gjenerike. Parashtesa e protokollit në URL-në burimore identifikon ofruesin (p.sh., github://, gcs://).

  • skill_registry

    Një burim aftësish nga Shërbimi i Regjistrit të Aftësive. Aftësi: projects/{project}/locations/{location}/skills/{skill} Rishikimi i Aftësive: projects/{project}/locations/{location}/skills/{skill}/revisions/{revision} Mbështet montimin e të gjitha aftësive në kuadër të një projekti: projects/{project}/locations/{location}/skills.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "remote" .

varg përshkrimi (opsional)

Përshkrimi i agjentit që zhvilluesit ta lexojnë dhe ta kuptojnë shpejt.

vargu i identifikimit (opsional)

Identifikuesi unik për agjentin.

vargu i udhëzimit_të_sistem-it (opsional)

Udhëzime sistemi për agjentin.

grup mjetesh (AgentTool) (opsionale)

Mjetet në dispozicion të agjentit.

Një mjet që agjenti mund ta përdorë.

Llojet e mundshme

Ekzekutimi i Kodit

Një mjet që mund të përdoret nga modeli për të ekzekutuar kodin.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "code_execution" .

Funksioni

Një mjet që mund të përdoret nga modeli.

varg përshkrimi (opsional)

Një përshkrim i funksionit.

varg emri (opsional)

Emri i funksionit.

objekt parametrash (opsional)

Skema JSON për parametrat e funksionit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "function" .

Kërkimi në Google

Një mjet që mund të përdoret nga modeli për të kërkuar në Google.

vargu search_types (enum (string)) (opsional)

Llojet e tokëzimit të kërkimit që duhen aktivizuar.

Vlerat e mundshme:

  • web_search

    Vendosja e kësaj fushe aktivizon kërkimin në internet. Kthehen vetëm rezultatet me tekst.

  • image_search

    Vendosja e kësaj fushe aktivizon kërkimin e imazheve. Kthehen bajtet e imazheve.

  • enterprise_web_search

    Vendosja e kësaj fushe aktivizon kërkimin në internet të ndërmarrjes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "google_search" .

McpServer

Një MCPServer është një server që mund të thirret nga modeli për të kryer veprime.

vargu allowed_tools (AllowedTools) (opsional)

Mjetet e lejuara.

Konfigurimi për mjetet e lejuara.

Fushat

enumimi i modalitetit (vargu) (opsional)

Mënyra e zgjedhjes së mjetit.

Vlerat e mundshme:

  • auto

    Zgjedhja e mjetit automatik.

  • any

    Çdo zgjedhje mjeti.

  • none

    Pa zgjedhje mjetesh.

  • validated

    Zgjedhje e mjetit të validuar.

varg mjetesh (varg) (opsional)

Emrat e mjeteve të lejuara.

objekti i headers (opsional)

Opsionale: Fushat për titujt e vërtetimit, afatet kohore, etj., nëse është e nevojshme.

varg emri (opsional)

Emri i MCPServer-it.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "mcp_server" .

vargu i url- së (opsional)

URL-ja e plotë për pikën fundore të MCPServer. Shembull: "https://api.example.com/mcp"

Konteksti i Url-it

Një mjet që mund të përdoret nga modeli për të marrë kontekstin e URL-së.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "url_context" .

Krijo Agjent

Shembull Përgjigjeje 

{
  "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"
}

Agjent me Burime

Shembull Përgjigjeje 

{
  "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"
}

Agjenti i ndarë nga Mjedisi

Shembull Përgjigjeje 

{
  "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"
}

Agjentët e Listës

merrni https://generativelanguage.googleapis.com/v1beta/agents

Liston të gjithë agjentët.

Parametrat e Shtegut / Pyetjes

numër i plotë i madhësisë së faqes (opsional)

Nuk është dhënë përshkrim.

vargu i shenjës së faqes (opsional)

Nuk është dhënë përshkrim.

vargu prind (opsional)

Nuk është dhënë përshkrim.

Përgjigje

Nëse është i suksesshëm, trupi i përgjigjes përmban të dhëna me strukturën e mëposhtme:

varg agjentësh ( Agjent ) (opsional)

Nuk është dhënë përshkrim.

vargu i shenjës së faqes_next_page (opsional)

Nuk është dhënë përshkrim.

Lista e Agjentëve

Shembull Përgjigjeje 

{
  "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"
}

GetAgent

merrni https://generativelanguage.googleapis.com/v1beta/agents/{id}

Merr një agjent specifik.

Parametrat e Shtegut / Pyetjes

vargu i identifikimit (i detyrueshëm)

Nuk është dhënë përshkrim.

Përgjigje

Nëse është i suksesshëm, trupi i përgjigjes përmban të dhëna me strukturën e mëposhtme:

agent_config AntigravityAgentConfig (opsionale)

Parametrat e konfigurimit për agjentin.

Konfigurimi për kohën e ekzekutimit të agjentit Antigravity. Ofron kontroll nga ana e serverit mbi mjedisin e ekzekutimit të agjentit dhe konfigurimin e mjetit.

Fushat

vargu max_total_tokens (opsional)

Totali maksimal i tokenëve për ekzekutimin e agjentit.

varg modeli (opsional)

Modeli që do të përdoret për arsyetimin e agjentit.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "antigravity" .

vargu i agjentit_bazë (opsional)

Agjenti bazë për t'u zgjeruar.

base_environment EnvironmentConfig ose varg (opsional)

Konfigurimi i mjedisit për agjentin.

Konfigurimi për një mjedis të personalizuar.

Fushat

vargu environment_id (opsional)

Opsionale. ID-ja e mjedisit për bashkëveprimin. Nëse specifikohet, kërkesa do të përditësojë mjedisin ekzistues në vend që të krijojë një të ri.

network EnvironmentNetworkEgressAllowlist ose enum (string) (opsionale)

Konfigurimi i rrjetit për mjedisin.

Konfigurimi i rrjetit dalës për sandbox-in. Pranon një objekt me një matricë 'allowlist' për të kufizuar trafikun, ose vargun 'disabled' për të çaktivizuar të gjithë aksesin në rrjet. Hiqeni plotësisht për të lejuar të gjithë trafikun dalës pa injektim në kokë.

Llojet e mundshme

objekt

Konfigurimi i rrjetit dalës për sandbox-in. Kur specifikohet, kufizon se cilat domene të jashtme mund të arrijë sandbox-i. Hiqeni plotësisht për të lejuar të gjithë trafikun dalës pa injektim të kokës.

vargu i listës së lejimeve (AllowlistEntry) (opsionale)

Lista e domeneve të lejuara dalëse. Lejohen vetëm kërkesat për domenet e listuara. Përdorni [{'domain': '*'}] për të lejuar të gjitha domenet, ndërkohë që ende injektohen tituj në ato specifike.

Një rregull i listës së lejimeve të një domeni të vetëm me injeksion opsional të kokës.

Fushat

varg domeni (opsional)

Domeni për të lejuar kërkesat dalëse. Mbështet shenjat karakteristike (p.sh. '*.googleapis.com'). Përdorni '*' për të lejuar të gjitha domenet.

transformimi i vargut (objektit) ose objektit (opsional)

Tituj për t'u injektuar në të gjitha kërkesat dalëse që përputhen me këtë domen. Pranon një diktat të vetëm ose një listë diktatesh. Proxy i daljes i injekton këto automatikisht.

varg

Çaktivizon të gjithë rrjetin.

Vlerat e mundshme

  • disabled

    Çaktivizon të gjithë rrjetin.

vargu i burimeve (Burimi) (opsional)

Nuk është dhënë përshkrim.

Një burim që do të montohet në mjedis.

Fushat

varg përmbajtjeje (opsionale)

Përmbajtja brenda rreshtit nëse `tipi` është `INLINE`.

vargu i kodimit (opsional)

Kodim opsional për përmbajtjen brenda rreshtit (p.sh. `base64`).

vargu burimor (opsional)

Burimi i mjedisit. Për Cloud Storage, kjo është shtegu i Cloud Storage. Për GitHub, kjo është shtegu i GitHub.

vargu i synuar (opsional)

Ku duhet të shfaqet burimi në mjedis.

tipi enum (string) (opsionale)

Nuk është dhënë përshkrim.

Vlerat e mundshme:

  • gcs

    Një kovë Ruajtjeje në Cloud.

  • inline

    Përmbajtje e integruar.

  • repository

    Një depo gjenerike. Parashtesa e protokollit në URL-në burimore identifikon ofruesin (p.sh., github://, gcs://).

  • skill_registry

    Një burim aftësish nga Shërbimi i Regjistrit të Aftësive. Aftësi: projects/{project}/locations/{location}/skills/{skill} Rishikimi i Aftësive: projects/{project}/locations/{location}/skills/{skill}/revisions/{revision} Mbështet montimin e të gjitha aftësive në kuadër të një projekti: projects/{project}/locations/{location}/skills.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "remote" .

varg përshkrimi (opsional)

Përshkrimi i agjentit që zhvilluesit ta lexojnë dhe ta kuptojnë shpejt.

vargu i identifikimit (opsional)

Identifikuesi unik për agjentin.

vargu i udhëzimit_të_sistem-it (opsional)

Udhëzime sistemi për agjentin.

grup mjetesh (AgentTool) (opsionale)

Mjetet në dispozicion të agjentit.

Një mjet që agjenti mund ta përdorë.

Llojet e mundshme

Ekzekutimi i Kodit

Një mjet që mund të përdoret nga modeli për të ekzekutuar kodin.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "code_execution" .

Funksioni

Një mjet që mund të përdoret nga modeli.

varg përshkrimi (opsional)

Një përshkrim i funksionit.

varg emri (opsional)

Emri i funksionit.

objekt parametrash (opsional)

Skema JSON për parametrat e funksionit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "function" .

Kërkimi në Google

Një mjet që mund të përdoret nga modeli për të kërkuar në Google.

vargu search_types (enum (string)) (opsional)

Llojet e tokëzimit të kërkimit që duhen aktivizuar.

Vlerat e mundshme:

  • web_search

    Vendosja e kësaj fushe aktivizon kërkimin në internet. Kthehen vetëm rezultatet me tekst.

  • image_search

    Vendosja e kësaj fushe aktivizon kërkimin e imazheve. Kthehen bajtet e imazheve.

  • enterprise_web_search

    Vendosja e kësaj fushe aktivizon kërkimin në internet të ndërmarrjes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "google_search" .

McpServer

Një MCPServer është një server që mund të thirret nga modeli për të kryer veprime.

vargu allowed_tools (AllowedTools) (opsional)

Mjetet e lejuara.

Konfigurimi për mjetet e lejuara.

Fushat

enumimi i modalitetit (vargu) (opsional)

Mënyra e zgjedhjes së mjetit.

Vlerat e mundshme:

  • auto

    Zgjedhja e mjetit automatik.

  • any

    Çdo zgjedhje mjeti.

  • none

    Pa zgjedhje mjetesh.

  • validated

    Zgjedhje e mjetit të validuar.

varg mjetesh (varg) (opsional)

Emrat e mjeteve të lejuara.

objekti i headers (opsional)

Opsionale: Fushat për titujt e vërtetimit, afatet kohore, etj., nëse është e nevojshme.

varg emri (opsional)

Emri i MCPServer-it.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "mcp_server" .

vargu i url- së (opsional)

URL-ja e plotë për pikën fundore të MCPServer. Shembull: "https://api.example.com/mcp"

Konteksti i Url-it

Një mjet që mund të përdoret nga modeli për të marrë kontekstin e URL-së.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "url_context" .

Merrni Agjentin

Shembull Përgjigjeje 

{
  "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"
}

FshijAgjentin

fshi https://generativelanguage.googleapis.com/v1beta/agents/{id}

Fshin një Agjent.

Parametrat e Shtegut / Pyetjes

vargu i identifikimit (i detyrueshëm)

Nuk është dhënë përshkrim.

Përgjigje

Nëse ka sukses, përgjigja është bosh.

Fshij Agjentin

Burimet

Agjent

Një përkufizim agjenti për API-në CreateAgent. Ky mesazh është objektivi për analizimin JSON të bazuar në analizues shënimesh. Formati i ri: { "id": "customer-sentinel", "base_agent": "", "system_instruction": "...", "base_environment": { "type": "remote", "sources": [...] }, "tools": [ {"type": "code_execution"} ] }

Fushat

agent_config AntigravityAgentConfig (opsionale)

Parametrat e konfigurimit për agjentin.

Konfigurimi për kohën e ekzekutimit të agjentit Antigravity. Ofron kontroll nga ana e serverit mbi mjedisin e ekzekutimit të agjentit dhe konfigurimin e mjetit.

Fushat

vargu max_total_tokens (opsional)

Totali maksimal i tokenëve për ekzekutimin e agjentit.

varg modeli (opsional)

Modeli që do të përdoret për arsyetimin e agjentit.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "antigravity" .

vargu i agjentit_bazë (opsional)

Agjenti bazë për t'u zgjeruar.

base_environment EnvironmentConfig ose varg (opsional)

Konfigurimi i mjedisit për agjentin.

Konfigurimi për një mjedis të personalizuar.

Fushat

vargu environment_id (opsional)

Opsionale. ID-ja e mjedisit për bashkëveprimin. Nëse specifikohet, kërkesa do të përditësojë mjedisin ekzistues në vend që të krijojë një të ri.

network EnvironmentNetworkEgressAllowlist ose enum (string) (opsionale)

Konfigurimi i rrjetit për mjedisin.

Konfigurimi i rrjetit dalës për sandbox-in. Pranon një objekt me një matricë 'allowlist' për të kufizuar trafikun, ose vargun 'disabled' për të çaktivizuar të gjithë aksesin në rrjet. Hiqeni plotësisht për të lejuar të gjithë trafikun dalës pa injektim në kokë.

Llojet e mundshme

objekt

Konfigurimi i rrjetit dalës për sandbox-in. Kur specifikohet, kufizon se cilat domene të jashtme mund të arrijë sandbox-i. Hiqeni plotësisht për të lejuar të gjithë trafikun dalës pa injektim të kokës.

vargu i listës së lejimeve (AllowlistEntry) (opsionale)

Lista e domeneve të lejuara dalëse. Lejohen vetëm kërkesat për domenet e listuara. Përdorni [{'domain': '*'}] për të lejuar të gjitha domenet, ndërkohë që ende injektohen tituj në ato specifike.

Një rregull i listës së lejimeve të një domeni të vetëm me injeksion opsional të kokës.

Fushat

varg domeni (opsional)

Domeni për të lejuar kërkesat dalëse. Mbështet shenjat karakteristike (p.sh. '*.googleapis.com'). Përdorni '*' për të lejuar të gjitha domenet.

transformimi i vargut (objektit) ose objektit (opsional)

Tituj për t'u injektuar në të gjitha kërkesat dalëse që përputhen me këtë domen. Pranon një diktat të vetëm ose një listë diktatesh. Proxy i daljes i injekton këto automatikisht.

varg

Çaktivizon të gjithë rrjetin.

Vlerat e mundshme

  • disabled

    Çaktivizon të gjithë rrjetin.

vargu i burimeve (Burimi) (opsional)

Nuk është dhënë përshkrim.

Një burim që do të montohet në mjedis.

Fushat

varg përmbajtjeje (opsionale)

Përmbajtja brenda rreshtit nëse `tipi` është `INLINE`.

vargu i kodimit (opsional)

Kodim opsional për përmbajtjen brenda rreshtit (p.sh. `base64`).

vargu burimor (opsional)

Burimi i mjedisit. Për Cloud Storage, kjo është shtegu i Cloud Storage. Për GitHub, kjo është shtegu i GitHub.

vargu i synuar (opsional)

Ku duhet të shfaqet burimi në mjedis.

tipi enum (string) (opsionale)

Nuk është dhënë përshkrim.

Vlerat e mundshme:

  • gcs

    Një kovë Ruajtjeje në Cloud.

  • inline

    Përmbajtje e integruar.

  • repository

    Një depo gjenerike. Parashtesa e protokollit në URL-në burimore identifikon ofruesin (p.sh., github://, gcs://).

  • skill_registry

    Një burim aftësish nga Shërbimi i Regjistrit të Aftësive. Aftësi: projects/{project}/locations/{location}/skills/{skill} Rishikimi i Aftësive: projects/{project}/locations/{location}/skills/{skill}/revisions/{revision} Mbështet montimin e të gjitha aftësive në kuadër të një projekti: projects/{project}/locations/{location}/skills.

objekt tipi (opsionale)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "remote" .

varg përshkrimi (opsional)

Përshkrimi i agjentit që zhvilluesit ta lexojnë dhe ta kuptojnë shpejt.

vargu i identifikimit (opsional)

Identifikuesi unik për agjentin.

vargu i udhëzimit_të_sistem-it (opsional)

Udhëzime sistemi për agjentin.

grup mjetesh (AgentTool) (opsionale)

Mjetet në dispozicion të agjentit.

Një mjet që agjenti mund ta përdorë.

Llojet e mundshme

Ekzekutimi i Kodit

Një mjet që mund të përdoret nga modeli për të ekzekutuar kodin.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "code_execution" .

Funksioni

Një mjet që mund të përdoret nga modeli.

varg përshkrimi (opsional)

Një përshkrim i funksionit.

varg emri (opsional)

Emri i funksionit.

objekt parametrash (opsional)

Skema JSON për parametrat e funksionit.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "function" .

Kërkimi në Google

Një mjet që mund të përdoret nga modeli për të kërkuar në Google.

vargu search_types (enum (string)) (opsional)

Llojet e tokëzimit të kërkimit që duhen aktivizuar.

Vlerat e mundshme:

  • web_search

    Vendosja e kësaj fushe aktivizon kërkimin në internet. Kthehen vetëm rezultatet me tekst.

  • image_search

    Vendosja e kësaj fushe aktivizon kërkimin e imazheve. Kthehen bajtet e imazheve.

  • enterprise_web_search

    Vendosja e kësaj fushe aktivizon kërkimin në internet të ndërmarrjes.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "google_search" .

McpServer

Një MCPServer është një server që mund të thirret nga modeli për të kryer veprime.

vargu allowed_tools (AllowedTools) (opsional)

Mjetet e lejuara.

Konfigurimi për mjetet e lejuara.

Fushat

enumimi i modalitetit (vargu) (opsional)

Mënyra e zgjedhjes së mjetit.

Vlerat e mundshme:

  • auto

    Zgjedhja e mjetit automatik.

  • any

    Çdo zgjedhje mjeti.

  • none

    Pa zgjedhje mjetesh.

  • validated

    Zgjedhje e mjetit të validuar.

varg mjetesh (varg) (opsional)

Emrat e mjeteve të lejuara.

objekti i headers (opsional)

Opsionale: Fushat për titujt e vërtetimit, afatet kohore, etj., nëse është e nevojshme.

varg emri (opsional)

Emri i MCPServer-it.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "mcp_server" .

vargu i url- së (opsional)

URL-ja e plotë për pikën fundore të MCPServer. Shembull: "https://api.example.com/mcp"

Konteksti i Url-it

Një mjet që mund të përdoret nga modeli për të marrë kontekstin e URL-së.

lloji i objektit (i detyrueshëm)

Nuk është dhënë përshkrim.

Gjithmonë i vendosur në "url_context" .