Bildirim Temelli API

Alexandra Klepper
Alexandra Klepper
GitHub Bluesky
François Beaufort
François Beaufort
GitHub

Yayın tarihi: 18 Mayıs 2026

Açıklayıcı Web Uzantılar Chrome Durumu Amaç
GitHub Kaynak denemesi Kaynak denemesi Görünüm Deneme Amacı (Intent to Experiment)

Bildirimsel API'yi kullanarak standart HTML formlarını ek açıklamalar ekleyerek WebMCP araçlarına dönüştürün. Ek açıklamalar, aracın adını ve amacını <form> öğesinde tanımlarken alanlar araç parametreleri olarak işlev görür. Tarayıcı, bu öğeleri aracıların zorunlu araçlara benzer şekilde kullanabileceği yapılandırılmış bir temsile çevirir.

Bu API'yi kullanmadan önce kullanım alanları örnekleri hakkında bilgi edinin.

Araç kaydı

Formunuza aşağıdaki HTML özelliklerini ekleyin:

  • toolname: Aracın adını amacına göre net bir şekilde belirtin.
  • tooldescription: Aracın hangi işlemi gerçekleştirdiğini ve amacını açıklayın.

Örneğin, aşağıdaki form example.com/get-customer-support adresinde bulunuyor:

<form toolname="createSupportRequest" tooldescription="Submits a request for customer support.">
</form>

Bir temsilci toolname numaralı telefonu aradığında tarayıcı, formu ön plana çıkarır ve alanını doldurur. Form, kullanıcı tarafından görünmeye devam eder.

toolname veya tooldescription HTML özelliğini kaldırırsanız araç kayıttan kaldırılır.

(İsteğe bağlı) Araç parametreleri

Doğruluğu artırmak için aşağıdaki HTML özelliklerini tek tek form öğelerine ekleyin:

  • toolparamdescription: Öğeleri JSON şemasındaki bir özellik açıklamasıyla eşleyin. Bu özellik olmadan tarayıcı, ilişkili <label> içindeki içeriği kullanır ve etiketlenebilir alt öğeleri atlar. Etiket yoksa tarayıcı aria-description öğesine başvurur.

Aşağıdaki formda, <select> öğesi için isteğe bağlı parametreler kullanılmaktadır.

<form toolname="supportRequestTool"
  tooldescription="Submit a request for support."
  action="/submit">

  <label for="firstName">First Name</label>
  <input type=text name=firstName>

  <label for="lastName">Last Name</label>
  <input type=text name=lastName>

  <select name="select" required
    toolparamdescription="Determines what team this request is routed to.">
    <option value="Customer happiness team">Return my purchase.</option>
    <option value="Distribution team">Check where my package is.</option>
    <option value="Website support team">Get help on the website.</option>
  </select>

  <button type=submit>Submit</button>
</form>

Tarayıcı bu formu, aşağıdaki JSON ile gösterilen bir araç olarak yorumlar:

[
  {
    "name": "supportRequestTool",
    "description": "Submit a request for support.",
    "inputSchema": {
      "type": "object",
      "properties": {
        "firstName": {
          "type": "string"
        },
        "lastName": {
          "type": "string"
        },
        "select": {
          "type": "string",
          "anyOf": [
            {
              "type":