Panduan Penggunaan Alat Inti OpenAPI MCP Server - OpenAPI Explorer

Saat memanggil Alibaba Cloud OpenAPI, Anda perlu mencari nama API, menyusun parameter permintaan, serta menangani pagination dan panggilan lintas wilayah. OpenAPI MCP Server Core Edition (selanjutnya disebut “Core Edition”) menyediakan 15 alat bawaan yang memungkinkan pemanggilan API, orkestrasi multi-langkah, manajemen sumber daya Terraform, dan pencarian dokumentasi melalui bahasa alami. Alat ini kompatibel dengan AI Agent umum (misalnya Qoder, Claude Code, CodeX). Berikut dijelaskan fungsi, parameter, dan penggunaan masing-masing alat.

Prasyarat

Konfigurasi dan integrasi Core Edition MCP Server telah selesai. Untuk detailnya, lihat OpenAPI MCP Server.
Verifikasi koneksi MCP. Masukkan “List Alibaba Cloud compute-related products” dalam percakapan AI Agent. Jika daftar produk dikembalikan, koneksi berfungsi dengan baik.

Ikhtisar Alat

Core Edition mencakup 15 alat, dikelompokkan ke dalam lima kategori berikut:

Kategori	Alat	Deskripsi
API Discovery	ListProducts	List all Alibaba Cloud products and metadata
	ListApis	List all APIs under a specified product
	GetApiDefinition	Get complete parameter definitions of an API
	SearchApis	Recommend matching OpenAPI based on natural language description
	ListProductRegions	List regions supported by a product
API Execution	GenerateCLICommand	Generate CLI command (without executing)
API Execution	CallCLI	Execute Alibaba Cloud CLI command
Advanced Orchestration	RunScript	Execute Python scripts with multi-API orchestration
Advanced Orchestration	GetTask	Poll asynchronous task status
Infrastructure as Code	GetPresignedUrl	Generate OSS presigned URL
Infrastructure as Code	RunIaC	Execute Terraform HCL code
Document Search	SearchDocuments	Search documentation
	GetDocument	Get document Markdown content
	GetDocumentTree	Browse product document directory tree
	GrepDocuments	Match document content by keyword

Detail Alat

API Discovery

ListProducts

Saat perlu mengetahui produk Alibaba Cloud yang tersedia, AI Agent menggunakan alat ini untuk menanyakan katalog produk. Misalnya, memasukkan “What compute-related products does Alibaba Cloud have” menyebabkan AI Agent mengekstraksi kata kunci dan menyaring daftar produk sesuai kebutuhan.

Panduan Penggunaan

Tentukan kata kunci produk dalam deskripsi. Misalnya, “What compute-related products does Alibaba Cloud have” lebih baik daripada “What products does Alibaba Cloud have”.
Hasil kueri dapat digunakan sebagai konteks untuk percakapan selanjutnya. Misalnya, pertama tanyakan “What database products are available”, lalu lanjutkan dengan detail operasional spesifik untuk produk tertentu.

Contoh Pemanggilan Alat

Input:

{
  "filter": "compute"
}

Output:

[
  {
    "code": "Ess",
    "name": "Auto Scaling",
    "group": "Elastic Computing",
    "style": "RPC",
    "versions": ["2014-08-28", "2022-02-22"],
    "defaultVersion": "2022-02-22"
  },
  {
    "code": "Ecs",
    "name": "Elastic Compute Service",
    "group": "Elastic Computing",
    "style": "RPC",
    "versions": ["2014-05-26"],
    "defaultVersion": "2014-05-26"
  },
  {
    "code": "Eci",
    "name": "Elastic Container Instance",
    "group": "Elastic Computing",
    "style": "RPC",
    "versions": ["2018-08-08"],
    "defaultVersion": "2018-08-08"
  }
]
// More results returned, only 3 shown here

ListApis

Saat operasi pengguna melibatkan produk tertentu tetapi AI Agent perlu mengonfirmasi operasi API yang tepat, alat ini digunakan untuk menelusuri daftar API produk tersebut. Misalnya, memasukkan “Allocate a public IP to an ECS instance” dapat menyebabkan AI Agent terlebih dahulu menanyakan API ECS mana yang relevan, lalu memilih yang sesuai untuk dieksekusi.

Panduan Penggunaan

Jelaskan produk dan aksi sejelas mungkin saat menggambarkan maksud operasional. Misalnya, “allocate a public IP to an ECS instance” lebih baik daripada “allocate IP”.

Contoh Pemanggilan Alat

Input:

{
  "product": "Ecs",
  "filter": "Instance"
}

Output:

[
  {
    "summary": "Allocates a public IP address to an ECS instance.",
    "apiName": "AllocatePublicIpAddress",
    "title": "Allocate Public IP"
  },
  {
    "summary": "Attaches a RAM role to one or more ECS instances.",
    "apiName": "AttachInstanceRamRole",
    "title": "Attach RAM Role to Instance"
  }
]
// More results returned, only 2 shown here

GetApiDefinition

Saat permintaan pengguna melibatkan pemanggilan API, AI Agent biasanya terlebih dahulu menemukan API target melalui SearchApis atau ListApis, lalu menggunakan alat ini untuk mendapatkan definisi parameter API, dan akhirnya menyusun pemanggilan yang benar. Misalnya, memasukkan “Query ECS instances in Hangzhou region” menyebabkan AI Agent terlebih dahulu menemukan API DescribeInstances, lalu mengonfirmasi parameter yang diperlukan melalui alat ini sebelum mengeksekusi.

Panduan Penggunaan

Jelaskan maksud operasional sejelas mungkin. Setelah AI Agent menemukan API yang benar, alat ini secara otomatis mengonfirmasi parameter dan mengeksekusi.

Contoh Pemanggilan Alat

Input:

{
  "product": "Ecs",
  "apiVersion": "2014-05-26",
  "apiName": "DescribeInstances"
}

Output:

{
  "summary": "Queries an instance list based on different request conditions",
  "methods": ["post", "get"],
  "parameters": ["...45 parameters total, omitted here"],
  "responses": {"...": "omitted"},
  "errorCodes": ["...omitted"]
}

SearchApis

Saat nama API yang tepat tidak diketahui, AI Agent menggunakan alat ini untuk mencocokkan OpenAPI Alibaba Cloud yang sesuai berdasarkan deskripsi bahasa alami. Misalnya, memasukkan “How to view ECS instance monitoring data” menyebabkan AI Agent mencari dan menemukan API pemantauan yang relevan.

Panduan Penggunaan

Sertakan nama produk dalam deskripsi. Misalnya, “query ECS security group rules” lebih baik daripada “query security groups”.
Pisahkan kebutuhan kompleks menjadi beberapa pertanyaan independen, masing-masing sesuai dengan satu operasi API.
Jika nama API sudah diketahui, sebutkan langsung ke AI Agent (misalnya, “use DescribeInstances to query”) untuk melewati langkah pencarian.

Contoh Pemanggilan Alat

Input:

{
  "prompt": "How to view ECS instance monitoring data",
  "limit": 3
}

Output:

[
  {
    "apiName": "DescribeInstanceMonitorData",
    "code": "Ecs",
    "description": "Calls DescribeInstanceMonitorData to query monitoring information for an ECS instance. Available metrics include vCPU utilization, burstable instance credits, received data traffic, sent data traffic, and average bandwidth.",
    "weight": 0.98,
    "version": "2014-05-26"
  },
  {
    "apiName": "QueryMetricList",
    "code": "Cms",
    "description": "Queries monitoring data for a specified product instance over a period of time.",
    "weight": 0.85,
    "version": "2016-09-22"
  },
  {
    "apiName": "DescribeMetricLast",
    "code": "Cms",
    "description": "Queries the latest monitoring data for a specified metric.",
    "weight": 0.75,
    "version": "2019-01-01"
  }
]

ListProductRegions

Saat operasi melibatkan pemilihan wilayah, AI Agent menggunakan alat ini untuk mengonfirmasi apakah wilayah target mendukung produk tersebut. Misalnya, memasukkan “Can ECS be used in Ulanqab” atau “Create an ECS instance in Singapore” menyebabkan AI Agent terlebih dahulu memverifikasi ketersediaan wilayah.

Panduan Penggunaan

Tentukan nama produk dan wilayah target dalam kueri. Misalnya, “Can ECS be used in Ulanqab” lebih baik daripada “Can it be used in Ulanqab”.
Jika melibatkan beberapa wilayah, sebutkan masing-masing. Contohnya, “Konfirmasikan apakah ECS tersedia di Hangzhou, Shanghai, dan Singapura.”

Contoh Pemanggilan Alat

Input:

{
  "product": "Ecs"
}

Output:

{
  "code": 0,
  "data": {
    "type": "regional",
    "endpoints": [
      {
        "regionId": "us-west-1",
        "regionName": "US (Silicon Valley)",
        "public": "ecs.us-west-1.aliyuncs.com",
        "vpc": "ecs-vpc.us-west-1.aliyuncs.com"
      },
      {
        "regionId": "cn-hangzhou",
        "regionName": "China (Hangzhou)",
        "public": "ecs.cn-hangzhou.aliyuncs.com",
        "vpc": "ecs-vpc.cn-hangzhou.aliyuncs.com"
      }
    ]
  }
}
// More results returned, only 2 shown here

API Execution

GenerateCLICommand

Saat diminta untuk “hanya menghasilkan perintah tanpa mengeksekusi” atau saat AI Agent perlu melihat pratinjau perintah, alat ini menghasilkan string perintah CLI. AI Agent biasanya terlebih dahulu mengonfirmasi parameter melalui GetApiDefinition, lalu menghasilkan perintah melalui alat ini, dan akhirnya mengeksekusinya melalui CallCLI. Misalnya, memasukkan “Generate a command to query ECS instances in Hangzhou” mengembalikan perintah lengkap yang dapat dieksekusi di terminal lokal.

Panduan Penggunaan

Untuk mengeksekusi perintah secara manual di terminal lokal, mintalah AI Agent untuk “hanya menghasilkan perintah tanpa mengeksekusi.” Perintah yang dihasilkan dapat disalin dan digunakan langsung.

Contoh Pemanggilan Alat

Input:

{
  "product": "Ecs",
  "apiVersion": "2014-05-26",
  "apiName": "DescribeInstances",
  "regionId": "cn-hangzhou",
  "jsonApiParameters": "{\"Status\": \"Running\", \"PageSize\": 100}"
}

Output:

{
  "cli": "aliyun ecs describe-instances --page-size 100 --status Running --region cn-hangzhou"
}

CallCLI

Saat AI Agent mengetahui persis operasi API mana yang harus dieksekusi, alat ini digunakan untuk melakukan pemanggilan langsung. Ini adalah alat utama untuk pemanggilan API di Core Edition. Misalnya, memasukkan “Query running ECS instances in Hangzhou region” menyebabkan AI Agent menyusun perintah CLI dan mengeksekusi kueri tersebut.

Panduan Penggunaan

Perintah CLI yang dieksekusi oleh alat ini berjalan di server jarak jauh dan tidak dapat membaca file lokal.
Operasi penulisan (membuat, mengubah, atau menghapus sumber daya) dapat menimbulkan biaya. Mintalah AI Agent untuk mengonfirmasi isi operasi sebelum eksekusi.

Contoh Pemanggilan Alat

Input:

{
  "command": "aliyun ecs describe-instances --biz-region-id cn-hangzhou --status Running"
}

Output:

{
  "Instances": {
    "Instance": []
  },
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 0
}

Advanced Orchestration

RunScript

Saat satu pemanggilan API tidak cukup untuk memenuhi kebutuhan, AI Agent menggunakan alat ini untuk menulis skrip guna melakukan operasi batch. Misalnya, memasukkan “Count ECS instances across all regions” atau “Check all security groups for high-risk rules” menyebabkan AI Agent menulis skrip konkuren untuk menanyakan beberapa sumber daya secara bersamaan.

Panduan Penggunaan

Saat diperlukan agregasi, perbandingan, atau operasi batch, jelaskan cakupan dan tujuan secara jelas. Misalnya, “Count ECS instances across all regions” atau “Check all security groups for high-risk rules”.
Eksekusi skrip dapat memakan waktu beberapa detik hingga puluhan detik. Tunggu hasilnya dengan sabar.

Contoh Pemanggilan Alat

Input:

{
  "script": "regions = ['cn-hangzhou', 'cn-shanghai', 'cn-beijing']\nresponses = await asyncio.gather(*[\n    call_cli(product='Ecs', action='DescribeInstances',\n             params={'RegionId': r, 'PageSize': 100})\n    for r in regions\n], return_exceptions=True)\nresult = {r: res.get('TotalCount', 0) if isinstance(res, dict) else str(res)\n    for r, res in zip(regions, responses)}"
}

Output:

{
  "processID": "proc_1f7b02be133a41ee89135fafb833a972",
  "status": "Running",
  "nextAction": "CallGetTask",
  "result": null,
  "waitTimedOut": true,
  "message": "Task not in terminal state. Call AlibabaCloud___GetTask to wait for result.",
  "error": null
}

GetTask

Saat tugas RunScript atau RunIaC memerlukan waktu lama untuk dieksekusi, AI Agent menggunakan alat ini untuk menunggu penyelesaian tugas dan mengambil hasilnya. Alat ini dapat dipicu selama operasi yang memakan waktu seperti inspeksi lintas wilayah atau penerapan Terraform.

Panduan Penggunaan

Untuk operasi yang memakan waktu (seperti inspeksi lintas wilayah atau kueri batch), tunggu hasilnya dengan sabar.
Jika diperlukan persetujuan manual, selesaikan proses persetujuan sesuai petunjuk dan hasil akan terus dikembalikan.

Contoh Pemanggilan Alat

Input:

{
  "processID": "proc_1f7b02be133a41ee89135fafb833a972",
  "waitTimeoutSeconds": 25
}

Output:

{
  "processID": "proc_1f7b02be133a41ee89135fafb833a972",
  "status": "Succeeded",
  "nextAction": "None",
  "result": {
    "cn-hangzhou": 0,
    "cn-shanghai": 0,
    "cn-beijing": 0
  }
}

Infrastructure as Code

GetPresignedUrl

Saat alat RunIaC atau RunScript perlu mereferensikan file eksternal, AI Agent menggunakan alat ini untuk menghasilkan tautan unggah sementara. Misalnya, saat kode Terraform melebihi 64 KB atau skrip perlu memproses file data yang telah diunggah sebelumnya, AI Agent terlebih dahulu mengunggah file melalui alat ini sebelum mengeksekusi operasi selanjutnya.

Panduan Penggunaan

Saat melibatkan unggah file besar, mungkin perlu menunggu unggahan selesai sebelum mengeksekusi operasi selanjutnya.

RunIaC

Saat sumber daya cloud perlu dibuat, dimodifikasi, atau dihapus, AI Agent dapat menggunakan alat ini untuk mengelola infrastruktur melalui Terraform. Misalnya, memasukkan “Create a VPC in Hangzhou with CIDR 172.16.0.0/16” menyebabkan AI Agent terlebih dahulu menghasilkan konfigurasi sumber daya dan meninjau perubahan, lalu mengeksekusi pembuatan setelah dikonfirmasi.

Panduan Penggunaan

Saat menggambarkan kebutuhan sumber daya, tentukan wilayah, spesifikasi, dan penamaan secara jelas. Misalnya, “Create a VPC in Hangzhou with CIDR 172.16.0.0/16, named mcp-demo-vpc”.
Perubahan sumber daya mungkin memerlukan persetujuan manual. Selesaikan proses persetujuan sesuai petunjuk.

Document Search

SearchDocuments

Saat diajukan pertanyaan berbasis pengetahuan tentang penggunaan produk, metode konfigurasi, atau troubleshooting error, AI Agent menggunakan alat ini untuk mencari dokumentasi resmi Alibaba Cloud. Misalnya, memasukkan “How to optimize Function Compute cold start” atau “How to configure OSS Bucket Policy” memicu pencarian dokumen resmi yang sesuai.

Panduan Penggunaan

Menyertakan nama produk dalam kueri meningkatkan relevansi hasil pencarian. Misalnya, “OSS cross-origin configuration” lebih baik daripada “cross-origin configuration”.
Saat diperlukan dokumentasi untuk produk tertentu, sebutkan nama produknya. Misalnya, “Function Compute cold start optimization documentation” lebih baik daripada “cold start optimization”.

Contoh Pemanggilan Alat

Input:

{
  "query": "ECS instance creation",
  "limit": 3
}

Output:

{
  "results": [
    {
      "doc_id": 108442,
      "title": "Creation Methods",
      "url": "https://www.alibabacloud.com/help/zh/ecs/user-guide/create-instances/",
      "product": "Elastic Compute Service",
      "content": "This topic describes several methods of creating ECS instances...",
      "website": "cn",
      "language": "zh"
    },
    {
      "doc_id": 151725,
      "title": "ECS Instance Provisioning Methods",
      "url": "https://www.alibabacloud.com/help/zh/ecs/user-guide/provisioning-methods-of-ecs-instances",
      "product": "Elastic Compute Service",
      "content": "Manually create one or more instances...",
      "website": "cn",
      "language": "zh"
    }
  ],
  "matched_filters": {
    "product": "",
    "doc_type": null,
    "website": "cn",
    "language": "zh"
  }
}

GetDocument

Setelah AI Agent menemukan dokumen relevan melalui SearchDocuments, alat ini digunakan untuk membaca konten lengkap guna menjawab pertanyaan. Misalnya, memasukkan “How to optimize Function Compute cold start?” menyebabkan AI Agent terlebih dahulu mencari dan menemukan dokumen, lalu membaca teks lengkap dan menyusun jawaban.

Panduan Penggunaan

AI Agent secara otomatis membaca dan menyusun konten setelah menemukan dokumen. Seluruh proses transparan bagi pengguna.

Contoh Pemanggilan Alat

Input:

{
  "doc_id": 108442,
  "max_length": 500
}

Output:

{
  "doc_id": 108442,
  "url": "https://www.alibabacloud.com/help/ecs/user-guide/create-instances",
  "title": "Create Instances",
  "product": "ecs",
  "content": "This topic describes several methods of creating ECS instances..."
}

GetDocumentTree

Saat pengguna ingin memahami struktur dokumentasi suatu produk, AI Agent menggunakan alat ini untuk menelusuri pohon direktori dokumen. Misalnya, memasukkan “What does the OSS documentation structure look like” atau “What user guides does ECS have”.

Panduan Penggunaan

Tentukan nama produk dalam kueri. Misalnya, “What document categories does OSS have” atau “What chapters are under the ECS user guide”.

Contoh Pemanggilan Alat

Input:

{
  "doc_id": 108442,
  "depth": 1
}

Output:

{
  "product": "Elastic Compute Service",
  "website": "cn",
  "language": "zh",
  "children": [
    {"title": "User Guide", "doc_id": 2399509, "url": "https://www.alibabacloud.com/help/ecs/user-guide", "children": []},
    {"title": "Developer Reference", "doc_id": 2399511, "url": "https://www.alibabacloud.com/help/ecs/developer-reference", "children": []},
    {"title": "Billing", "doc_id": 25396, "children": []},
    {"title": "FAQ", "doc_id": 2983136, "children": []}
  ]
}
// This example uses depth=1, returning only top-level nodes. Set depth to 2 or 3 to include sub-chapters

GrepDocuments

Saat pertanyaan melibatkan istilah spesifik, item konfigurasi, atau kode kesalahan, AI Agent menggunakan alat ini untuk melakukan pencocokan kata kunci eksak dalam dokumentasi produk tertentu. Misalnya, memasukkan “What values does InstanceChargeType have in ECS documentation” atau “Search for CORS-related content in OSS documentation”.

Panduan Penggunaan

Tentukan produk dan kata kunci dalam kueri. Misalnya, “Search for DescribeInstanceAttribute in ECS documentation”.
Kata kunci yang lebih tepat menghasilkan hasil yang lebih relevan. Beberapa kata kunci memiliki hubungan AND.

Contoh Pemanggilan Alat

Input:

{
  "product": "ecs",
  "pattern": "DescribeInstanceAttribute",
  "limit": 3
}

Output:

{
  "product_code": "ecs",
  "pattern": "DescribeInstanceAttribute",
  "matches": [
    {
      "title": "DescribeInstanceAttribute - Query instance attribute information",
      "url": "https://www.alibabacloud.com/help/ecs/developer-reference/api-ecs-2014-05-26-describeinstanceattribute",
      "matched_text": "DescribeInstanceTypes - Query instance type information list\nDescribeInstanceAttribute - Query instance attribute information\nModifyInstanceAttribute - Modify instance attribute information",
      "line_no": 986
    }
  ],
  "total": 1,
  "truncated": false,
  "llms_txt_url": "https://www.alibabacloud.com/help/zh/ecs/llms.txt"
}

Kasus Penggunaan Khas

Skenario berikut menunjukkan alur kerja lengkap di mana beberapa alat bekerja sama untuk menyelesaikan tugas kompleks.

Menanyakan Aturan Security Group

Masukan pengguna:

Check the security group rules in the Hangzhou region

Rantai pemanggilan alat AI Agent yang mungkin:

Menggunakan SearchApis untuk mencari “Query security group rules associated with ECS instances”, menemukan API DescribeSecurityGroupAttribute (confidence 0.98).
Menggunakan GetApiDefinition untuk mengonfirmasi bahwa API memerlukan SecurityGroupId dan RegionId sebagai parameter wajib.
Menggunakan CallCLI untuk mengeksekusi kueri, mengembalikan daftar aturan security group (termasuk arah, protokol, range port, alamat sumber, dll.).

Alat yang terlibat: SearchApis, GetApiDefinition, CallCLI

Data Pemanggilan Lengkap

Langkah 1 - Input SearchApis:

{
  "prompt": "Query security group rules associated with ECS instances",
  "limit": 2
}

Langkah 1 - Output SearchApis:

[
  {
    "apiName": "DescribeSecurityGroupAttribute",
    "code": "Ecs",
    "description": "Queries detailed information about a specified security group and its associated security group rules.",
    "weight": 0.98,
    "version": "2014-05-26"
  },
  {
    "apiName": "DescribeSecurityGroupReferences",
    "code": "Ecs",
    "description": "Queries the list of other security groups that have been authorized by one or more specified security groups.",
    "weight": 0.75,
    "version": "2014-05-26"
  }
]

Langkah 3 - Input CallCLI:

{
  "command": "aliyun ecs describe-security-group-attribute --security-group-id sg-bp16kuncwlmc3849phsj --biz-region-id cn-hangzhou"
}

Langkah 3 - Output CallCLI (cuplikan):

{
  "InnerAccessPolicy": "Accept",
  "Permissions": {
    "Permission": [
      {
        "Direction": "ingress",
        "IpProtocol": "ALL",
        "Policy": "Accept",
        "PortRange": "-1/-1",
        "SourceCidrIp": "0.0.0.0/0"
      }
    ]
  },
  "SecurityGroupId": "sg-bp16kuncwlmc3849phsj",
  "SecurityGroupName": "China-Office-China-ec"
}

Inspeksi Batch Cross-Region

Masukan pengguna:

Count the number of ECS instances in Hangzhou, Shanghai, and Beijing regions

Rantai pemanggilan alat AI Agent yang mungkin:

Menggunakan RunScript untuk menulis skrip konkuren yang menanyakan jumlah instans di ketiga wilayah secara bersamaan.
Eksekusi skrip timeout (melebihi 20 detik), mengembalikan processID.
Menggunakan GetTask untuk memeriksa status tugas dan mengambil hasil setelah eksekusi skrip selesai.

Alat yang terlibat: RunScript, GetTask

Data Pemanggilan Lengkap

Langkah 1 - Input RunScript:

{
  "script": "regions = ['cn-hangzhou', 'cn-shanghai', 'cn-beijing']\nresponses = await asyncio.gather(*[\n    call_cli(product='Ecs', action='DescribeInstances',\n             params={'RegionId': r, 'PageSize': 100})\n    for r in regions\n], return_exceptions=True)\nresult = {r: res.get('TotalCount', 0) if isinstance(res, dict) else str(res)\n    for r, res in zip(regions, responses)}"
}

Langkah 1 - Output RunScript (timeout):

{
  "processID": "proc_1f7b02be133a41ee89135fafb833a972",
  "status": "Running",
  "nextAction": "CallGetTask",
  "result": null,
  "waitTimedOut": true,
  "message": "Task not in terminal state. Call AlibabaCloud___GetTask to wait for result."
}

Langkah 2 - Input GetTask:

{
  "processID": "proc_1f7b02be133a41ee89135fafb833a972",
  "waitTimeoutSeconds": 25
}

Langkah 2 - Output GetTask:

{
  "processID": "proc_1f7b02be133a41ee89135fafb833a972",
  "status": "Succeeded",
  "nextAction": "None",
  "result": {
    "cn-hangzhou": 0,
    "cn-shanghai": 0,
    "cn-beijing": 0
  }
}

Menyelesaikan Masalah Menggunakan Dokumentasi

Masukan pengguna:

Function Compute cold start latency is high. What optimization options are available?

Rantai pemanggilan alat AI Agent yang mungkin:

Menggunakan SearchDocuments untuk mencari “Function Compute cold start optimization”, menemukan dokumen “Best Practices for Function Compute Cold Start Optimization” (doc_id: 2513659).
Menggunakan GetDocument untuk membaca teks lengkap dokumen dan mengambil definisi cold start serta strategi optimasi.
Menggunakan GetDocumentTree untuk menelusuri direktori dokumen Function Compute dan mengidentifikasi bab dokumentasi tambahan terkait kinerja.

Alat yang terlibat: SearchDocuments, GetDocument, GetDocumentTree

Data Pemanggilan Lengkap

Langkah 1 - Input SearchDocuments:

{
  "query": "Function Compute cold start optimization",
  "limit": 2
}

Langkah 1 - Output SearchDocuments:

{
  "results": [
    {
      "doc_id": 2513659,
      "title": "Best Practices for Function Compute Cold Start Optimization",
      "url": "https://www.alibabacloud.com/help/zh/functioncompute/fc/use-cases/best-practice-for-reducing-cold-start-latencies",
      "product": "Function Compute",
      "content": "This topic describes how to optimize cold start for elastic instances by configuring minimum instance count in Function Compute to improve function performance."
    }
  ]
}

Langkah 2 - Input GetDocument:

{
  "doc_id": 2513659,
  "max_length": 300
}

Langkah 2 - Output GetDocument (cuplikan):

{
  "doc_id": 2513659,
  "title": "Best Practices for Function Compute Cold Start Optimization",
  "product": "functioncompute",
  "content": "This topic describes how to optimize cold start for elastic instances by configuring minimum instance count in Function Compute to improve function performance.\n\n## What is Cold Start\nFunction Compute uses elastic instances by default, meaning automatic scaling based on requests. When a request is received, the system automatically creates an instance to handle it. Instances are automatically recycled when no requests are pending."
}

Langkah 3 - Input GetDocumentTree:

{
  "product": "functioncompute",
  "depth": 1
}

Langkah 3 - Output GetDocumentTree (cuplikan):

{
  "product": "Function Compute",
  "children": [
    {"title": "Cloud Sandbox (FC Agent Sandbox)", "doc_id": 3030518},
    {"title": "Cloud Functions", "doc_id": 2838600}
  ]
}
// More results returned, only 2 shown here

OpenAPI Explorer:Panduan Penggunaan Alat Inti OpenAPI MCP Server

Prasyarat

Ikhtisar Alat

Detail Alat

API Discovery

ListProducts

ListApis

GetApiDefinition

SearchApis

ListProductRegions

API Execution

GenerateCLICommand

CallCLI

Advanced Orchestration

RunScript

GetTask

Infrastructure as Code

GetPresignedUrl

RunIaC

Document Search

SearchDocuments

GetDocument

GetDocumentTree

GrepDocuments

Kasus Penggunaan Khas

Menanyakan Aturan Security Group

Inspeksi Batch Cross-Region

Menyelesaikan Masalah Menggunakan Dokumentasi

Dokumentasi Terkait