Technical reference

Zengin çıktı protokolü

Asistan çıktısı, teslimat/oluşturma yönergelerini birkaç özel kanal üzerinden taşır:

  • Ek teslimatı için yapılandırılmış mediaUrl / mediaUrls alanları.
  • Ses sunumu ipuçları için [[audio_as_voice]].
  • Yanıt meta verileri için [[reply_to_current]] / [[reply_to:<id>]].
  • Control UI zengin oluşturması için [embed ...].

Yapılandırılmış medya alanları ve [[...]] etiketleri teslimat meta verileridir. [embed ...], yalnızca web'e özel ayrı zengin oluşturma yoludur; bir medya diğer adı değildir.

Medya ekleri

Uzak ekler herkese açık https: URL'leri olmalıdır. http:, local loopback, bağlantı-yerel, özel ve dahili ana bilgisayar adları ek yönergeleri olarak reddedilir; sunucu tarafındaki medya getiriciler buna ek olarak kendi ağ korumalarını uygular.

Yerel ekler mutlak yolları, çalışma alanına göreli yolları veya ana dizine göreli ~/ yollarını kabul eder. Teslimattan önce yine de aracının dosya okuma politikasından ve medya türü denetimlerinden geçerler.

Düz Markdown görsel sözdizimi (![alt](url)) varsayılan olarak metin biçiminde kalır. Markdown görsellerini medya yanıtları olarak işlemek isteyen kanallar, giden bağdaştırıcılarında bunu etkinleştirir; Telegram bunu yaptığı için ![alt](url) bir medya ekine dönüşür.

Blok akışı etkinleştirildiğinde medya, yapılandırılmış yük alanlarında taşınmalıdır. Aynı medya URL'si hem akışla gönderilen bir blokta hem de nihai asistan yükünde görünürse OpenClaw bunu bir kez teslim eder ve yinelenen öğeyi nihai yükten çıkarır.

[embed ...]

[embed ...], Control UI için aracının kullanabildiği tek zengin oluşturma sözdizimidir. Kendiliğinden kapanan örnek:

text
[embed ref="cv_123" title="Status" /]

Kurallar:

  • [view ...] artık yeni çıktılar için geçerli değildir.
  • Embed kısa kodları yalnızca asistan mesajı yüzeyinde oluşturulur.
  • Yalnızca URL destekli Embed'ler oluşturulur; ref="..." veya url="..." kullanın.
  • Blok biçimindeki satır içi HTML Embed kısa kodları oluşturulmaz.
  • Web kullanıcı arayüzü, kısa kodu görünür metinden çıkarır ve Embed'i satır içinde oluşturur.

Saklanan oluşturma biçimi

Normalleştirilmiş/saklanan asistan içerik bloğu, yapılandırılmış bir canvas öğesidir:

json
{  "type": "canvas",  "preview": {    "kind": "canvas",    "surface": "assistant_message",    "render": "url",    "viewId": "cv_123",    "url": "/__openclaw__/canvas/documents/cv_123/index.html",    "title": "Status",    "preferredHeight": 320  }}

present_view tanınmaz; saklanan/oluşturulan zengin bloklar her zaman bu canvas biçimini kullanır.

İlgili

Was this useful?
On this page

On this page