AgentLoop Console Embedded Sharing Integration Guide - AgentLoop

Genel Bakış

AgentLoop konsolu, üçüncü taraf sistemlere gömülerek entegre edilebilir. Oturum açma gerektirmeyen bir bağlantı aracılığıyla belirli bir AgentSpace sayfasını açabilir ve URL parametrelerini kullanarak gezinmeyi, sayfa üstbilgisini, AgentSpace değiştirme girişini ve bazı iş sayfalarının başlangıç durumunu kontrol edebilirsiniz.

Gömülü erişim için önerilen etki alanı şudur:

https://agentloop4service.console.alibabacloud.com

Normal konsol etki alanını gömülü etki alanıyla karıştırmayın. Oturum durumundaki tutarsızlıklar nedeniyle sayfaların erişilemez hale gelmesini önlemek için gömülü erişimde her zaman bu belgede belirtilen 4service etki alanını kullanın.

Sayfa URL biçimi

AgentSpace sayfası URL biçimi aşağıdaki gibidir:

https://agentloop4service.console.alibabacloud.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/{appPath}

Parametre açıklamaları:

Parametre	Açıklama
`{regionId}`	AgentSpace'in bulunduğu bölge, örneğin `cn-hangzhou`
`{agentSpaceName}`	AgentSpace adı
`{appPath}`	Açılacak sayfa yolu

Örnek:

https://agentloop4service.console.alibabacloud.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/agent-insight

Yaygın sayfa yolları:

Sayfa	appPath	Açıklama
Hızlı başlangıç	`quickstart`	Hızlı başlangıç sayfasını açar
Agent İçgörüler	`agent-insight`	Agent gözlemlenebilirlik analizi sayfasını açar
Agent karşılaştırması	`agent-comparison`	Agent karşılaştırma sayfasını açar
AI Agent Gözlemlenebilirliği	`llm_agent/app-list`	AI Agent Gözlemlenebilirliği ana girişini açar
Pano	`dashboard`	Pano sayfasını açar
Entegrasyon Merkezi	`integratingcenter`	Entegrasyon Merkezi sayfasını açar
Agent izleme geçmişi	`trajectory`	Agent izleme geçmişi sayfasını açar
Değerlendirme görevleri	`evaluate-task`	Değerlendirme görevleri sayfasını açar
Değerlendirme analiz içgörüsü	`explorer`	Değerlendirme analiz içgörüsü sayfasını açar
Değerlendirici	`evaluator`	Değerlendirici sayfasını açar
Deney planı	`experiment-plan`	Deney planı sayfasını açar
Deney kaydı	`experiment-record`	Deney kaydı sayfasını açar

Adres birleştirilirken {agentSpaceName} yol değişkeni URL kodlamasına tabi tutulmalıdır.

Oturum açma gerektirmeyen bağlantılar oluşturun

Alibaba Cloud Management Console oturum açma gerektirmeyen bağlantı oluşturma yöntemine başvurarak, AgentLoop hedef sayfasını Destination olarak kullanabilir ve bir iframe'e yerleştirilebilecek oturum açma gerektirmeyen bir bağlantı oluşturabilirsiniz.

Adım 1: Destination oluşturun

Destination , kullanıcıların oturum açma gerektirmeyen kimlik doğrulamasından sonra nihai olarak açacağı AgentLoop sayfasıdır.

const destination = new URL(
  'https://agentloop4service.console.alibabacloud.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/evaluate-task'
);

destination.searchParams.set('hiddenSwitch', 'true');
destination.searchParams.set('hiddenBackHome', 'true');
destination.searchParams.set(
  'embed',
  JSON.stringify({
    sidebar: 'hidden',
    header: 'hidden',
    eval: {
      dataSource: 'trace',
      serviceName: '{serviceName}',
    },
  })
);

Adım 2: Geçici kimlik bilgilerini alın

Üçüncü taraf sistem sunucusu, geçici kimlik bilgilerini almak için STS AssumeRole çağrısı yapar. Kullanıcı, kiracı veya iş kaynağı kapsamına göre en az ayrıcalık ilkesini yapılandırın. Bir belirteç yalnızca bir kez kullanılabilir. Ayrıntılar için AssumeRole konusuna bakın.

Yaygın parametreler:

Parametre	Açıklama
`RoleArn`	Üstlenilecek RAM rolünün ARN değeri
`RoleSessionName`	Oturum adı. Denetlenebilir bir iş kullanıcısı tanımlayıcısı kullanın.
`DurationSeconds`	Geçici kimlik bilgilerinin geçerlilik süresi
`Policy`	İsteğe bağlı. Bu oturumda erişilebilen kaynakların kapsamını daha da kısıtlamak için kullanılır.

Uzun vadeli AccessKey'i tarayıcı ön ucunda saklamayın veya iletmeyin.

Adım 3: SigninToken alın

SigninToken elde etmek için RAM tek oturum açma (SSO) özelliğini çağırın. Bağlantı biçimi aşağıdaki gibidir. Not: TicketType değeri mini olarak ayarlanmalıdır.

http://signin.alibabacloud.com/federation?Action=GetSigninToken
                    &AccessKeyId=<Temporary AK returned by STS>
                    &AccessKeySecret=<Temporary Secret returned by STS>
                    &SecurityToken=<Security Token returned by STS>
                    &TicketType=mini

Hassas bilgilerin ifşa edilmesini önlemek için, GetSigninToken yalnızca sunucu tarafında çağrılmalıdır. Geçici anahtarları tarayıcı ön ucunda birleştirmeyin veya ortaya çıkarmayın.

Adım 4: Oturum açma gerektirmeyen bağlantı oluşturun

Hazırlanan bağlantıya döndürülen SigninToken değerini ekleyerek parola gerektirmeyen erişim bağlantısını oluşturun.

const loginUrl = new URL('https://signin.alibabacloud.com/federation');

loginUrl.searchParams.set('Action', 'Login');
loginUrl.searchParams.set('LoginUrl', 'https://{your-domain}/login-expired');
loginUrl.searchParams.set('Destination', destination.toString());
loginUrl.searchParams.set('SigninToken', signinToken);

console.log(loginUrl.toString());

Son URL biçimi:

http://signin.alibabacloud.com/federation?Action=Login
                            &LoginUrl=<The address to redirect to when login expires, typically configured as a URL that performs a 302 redirect in your custom web service. Use encodeURL to encode LoginUrl.>
                            &Destination=<The actual page to access. If there are parameters, use encodeURL to encode them.>
                            &SigninToken=<The obtained login token. Use encodeURL to encode the token.>

iframe örneği:

<iframe
  src="{loginUrl}"
  width="100%"
  height="100%"
  frameborder="0"
  allowfullscreen
></iframe>

Gömülü parametreler

AgentLoop, gömülü sayfaların görüntülenmesini ve davranışını kontrol etmek için aşağıdaki URL parametrelerini destekler.

embed

embed , yapılandırılmış gömme yapılandırmasını bir JSON dizesi olarak iletmek için kullanılır. Bir URL'ye eklendiğinde URL kodlamasına tabi tutulmalıdır.

Okunabilir form:

?embed={"sidebar":"hidden","header":"hidden","eval":{"dataSource":"trace","serviceName":"{serviceName}"}}

Yapı tanımı:

interface EmbedConfig {
  sidebar?: 'hidden';
  header?: 'hidden';
  eval?: {
    dataSource?: 'trace' | 'atif' | 'log' | 'dataset';
    serviceName?: string;
    explorer?: {
      timePicker?: 'hidden';
      topBar?: 'hidden';
      filterSidebar?: 'hidden';
      timeRange?: {
        from: number;
        to: number;
      };
    };
  };
}

Parametre açıklamaları:

Parametre	Olası değerler	Açıklama
`embed.sidebar`	`hidden`	Logo, AgentSpace seçici, menü ve daraltma düğmesi dahil olmak üzere tüm AgentSpace sol taraf alanını gizler. Üçüncü taraf sistemin kendi gezinmesini sağladığı senaryolar için uygundur.
`embed.header`	`hidden`	Sayfa başlığı, üst sekmeler ve sağ taraftaki işlem alanı dahil olmak üzere AgentSpace içerik alanının üstbilgisini gizler. Alibaba Cloud Management Console'un en dıştaki üst çubuğunu kontrol etmez.
`embed.eval.dataSource`	`trace` / `atif` / `log` / `dataset`	Değerlendirme görevleri sayfasında görev oluşturma formu açıldığında veri kaynağı türünü önceden doldurur
`embed.eval.serviceName`	Hizmet adı	Değerlendirme görevleri sayfasında görev oluşturma formu açıldığında hizmet adını önceden doldurur
`embed.eval.explorer.timePicker`	`hidden`	Değerlendirme analiz içgörüsü sayfasındaki saat seçiciyi gizler
`embed.eval.explorer.topBar`	`hidden`	Değerlendirme analiz içgörüsü sayfasının üst kısmındaki arama, toplama ve günlük alanını gizler
`embed.eval.explorer.filterSidebar`	`hidden`	Değerlendirme analiz içgörüsü sayfasındaki filtre kenar çubuğunu gizler
`embed.eval.explorer.timeRange.from`	Sayı	Başlangıç saati, saniye düzeyinde Unix zaman damgası
`embed.eval.explorer.timeRange.to`	Sayı	Bitiş saati, saniye düzeyinde Unix zaman damgası

timeRange.from değeri timeRange.to değerinden küçük olmalı ve her iki değer de saniye düzeyinde Unix zaman damgası kullanmalıdır. embed.eval yalnızca görev oluşturma formunu önceden doldurur; formu otomatik olarak açmaz.

Oluşturma örneği:

const targetUrl = new URL(
  'https://agentloop4service.console.alibabacloud.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/evaluate-task'
);

targetUrl.searchParams.set(
  'embed',
  JSON.stringify({
    sidebar: 'hidden',
    eval: {
      dataSource: 'trace',
      serviceName: '{serviceName}',
    },
  })
);

console.log(targetUrl.toString());

Oluşturulan URL örneği:

https://agentloop4service.console.alibabacloud.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/evaluate-task?embed=%7B%22sidebar%22%3A%22hidden%22%2C%22eval%22%3A%7B%22dataSource%22%3A%22trace%22%2C%22serviceName%22%3A%22%7BserviceName%7D%22%7D%7D

hiddenSwitch

AgentSpace değiştirme girişini gizler.

hiddenSwitch=true

Üçüncü taraf sistem mevcut AgentSpace'i zaten sabitlediyse, kullanıcıların gömülü sayfa içinde diğer alanlara geçmesini önlemek için bu parametreyi etkinleştirin.

hiddenBackHome

"Ana Sayfaya Dön" girişini gizler.

hiddenBackHome=true

Üçüncü taraf sistem, kullanıcıların belirtilen AgentSpace sayfasında kalmasını istiyorsa, kullanıcıların AgentLoop ana sayfasına dönmesini önlemek için bu parametreyi etkinleştirin.

hiddenSwitch ve hiddenBackHome parametreleri yalnızca varlıklarına göre değerlendirilir. Değer false olsa bile, parametre URL'de göründüğü sürece etkili olur. AgentSpace değiştirme girişini veya ana sayfa girişini geri yüklemek için ilgili parametreyi URL'den kaldırın.

Önerilen parametre kombinasyonları

Sol taraf gezinmesini gizleyin

https://agentloop4service.console.alibabacloud.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/agent-insight?embed=%7B%22sidebar%22%3A%22hidden%22%7D

Sayfa üstbilgisini gizleyin

https://agentloop4service.console.alibabacloud.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/agent-insight?embed=%7B%22header%22%3A%22hidden%22%7D

https://agentloop4service.console.alibabacloud.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/agent-insight?embed=%7B%22sidebar%22%3A%22hidden%22%2C%22header%22%3A%22hidden%22%7D

Alan değiştirmeyi ve ana sayfaya dönüşü devre dışı bırakın

https://agentloop4service.console.alibabacloud.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/agent-insight?hiddenSwitch=true&hiddenBackHome=true&embed=%7B%22sidebar%22%3A%22hidden%22%2C%22header%22%3A%22hidden%22%7D

Gezinmeyi gizleyin ve değerlendirme görevi parametrelerini önceden doldurun

https://agentloop4service.console.alibabacloud.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/evaluate-task?hiddenSwitch=true&hiddenBackHome=true&embed=%7B%22sidebar%22%3A%22hidden%22%2C%22eval%22%3A%7B%22dataSource%22%3A%22trace%22%2C%22serviceName%22%3A%22%7BserviceName%7D%22%7D%7D

Değerlendirme analiz içgörüsü sayfasını basitleştirin

Adresi standart tarayıcı API'si ile oluşturmak, JSON, boşluklar ve tırnak işaretlerinin manuel olarak işlenmesini gerektirmez:

const targetUrl = new URL(
  'https://agentloop4service.console.alibabacloud.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/explorer'
);

targetUrl.searchParams.set(
  'embed',
  JSON.stringify({
    sidebar: 'hidden',
    header: 'hidden',
    eval: {
      explorer: {
        timePicker: 'hidden',
        topBar: 'hidden',
        filterSidebar: 'hidden',
        timeRange: {
          from: 1785427200,
          to: 1785513600,
        },
      },
    },
  })
);

console.log(targetUrl.toString());

Değerlendirme sayfası parametreleri

embed yapılandırmasına ek olarak, değerlendirme sayfaları belirli bir formu açan veya belirli bir başlangıç durumunu geri yükleyen küçük bir URL parametresi kümesini okur.

Görev oluşturma formunu otomatik olarak açın

Sayfa yolu:

/app/evaluate-task

Parametre açıklamaları:

Parametre	Gerekli	Olası değerler	Açıklama
`action`	Evet	`create`	Görev oluşturma formunu otomatik olarak açar
`dataSource`	Hayır	`trace` / `atif` / `log` / `dataset`	Veri kaynağını önceden doldurur
`datasetName`	Hayır	Veri kümesi adı	Veri kaynağı `dataset` olduğunda veri kümesini önceden doldurur

Örnek:

const targetUrl = new URL(
  'https://agentloop4service.console.alibabacloud.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/evaluate-task'
);

targetUrl.searchParams.set('action', 'create');
targetUrl.searchParams.set('dataSource', 'dataset');
targetUrl.searchParams.set('datasetName', '{datasetName}');

Sayfa bu tek seferlik parametreleri tükettikten sonra, action, dataSource ve datasetName parametreleri adres çubuğundan kaldırılır; böylece yenileme işlemi formu tekrar tetiklemez.

Görev düzenleme formunu açın

/app/evaluate-task?editTaskId={taskId}

editTaskId parametresi de tüketildikten sonra adres çubuğundan kaldırılır.

Görev ayrıntılarını açın

Sayfa yolu:

/app/evaluate-task-detail

Parametre açıklamaları:

Parametre	Gerekli	Açıklama
`taskId`	Mevcut bir görevi görüntülerken, kopyalarken veya düzenlerken gereklidir	Değerlendirme görevi kimliği
`type`	Hayır	`add`, `view`, `copy` veya `edit`. Varsayılan değer: `add`.
`action`	Hayır	Mevcut ayrıntı akışı, çalıştırma ilkesi alanına konumlandıran `start` değerini destekler.

Değerlendirme analiz içgörüsünün başlangıç durumunu ayarlayın

Sayfa yolu:

/app/explorer

Parametre açıklamaları:

Parametre	Tür	Varsayılan değer	Açıklama
`q`	Dize	Boş	Başlangıç sorgu deyimi. URL kodlamasına tabi tutulmalıdır.
`groupBy`	Dize	`none`	Başlangıç birincil toplama boyutu. Desteklenen değerler: `dataItem`, `evaluator`, `task`, `evaluationRun`, `status`, `agent` ve `dataset`.
`subGroupBy`	Dize	`none`	Başlangıç ikincil toplama boyutu. Değerler `groupBy` ile aynıdır ancak birincil toplama boyutuyla aynı olamaz.

Örnek:

const targetUrl = new URL(
  'https://agentloop4service.console.alibabacloud.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/explorer'
);

targetUrl.searchParams.set('q', 'status: success');
targetUrl.searchParams.set('groupBy', 'evaluator');

Toplama gerekmediğinde, groupBy ve subGroupBy parametrelerini atlayın veya bunları none olarak ayarlayın.

AI Agent Gözlemlenebilirliği sayfası

AI Agent Gözlemlenebilirliği sayfasının mevcut ana girişi şudur:

https://agentloop4service.console.alibabacloud.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/llm_agent/app-list

Ana giriş, iç sayfayı aşağıdaki sırayla seçer:

traceId aktarılırsa İzleme ayrıntıları açılır.
traceId aktarılmazsa ve targetPage=session-explorer ise Oturum Gezgini açılır.
Diğer tüm durumlarda AI uygulama listesi açılır.

Uygulama listesini açın

Ne traceId ne de targetPage aktarıldığında sayfa uygulama listesini açar.

https://agentloop4service.console.alibabacloud.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/llm_agent/app-list?hiddenSwitch=true&hiddenBackHome=true

İzleme ayrıntılarını açın

https://agentloop4service.console.alibabacloud.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/llm_agent/app-list?traceId={traceId}&startTime={startTime}&endTime={endTime}&hiddenSwitch=true&hiddenBackHome=true

Parametre açıklamaları:

Parametre	Gerekli	Açıklama
`traceId`	Evet	İzleme kimliği. Ana giriş büyük/küçük harfe duyarlıdır, bu nedenle bu yazımı kullanın.
`startTime`	Hayır	Sorgu başlangıç zamanı. AgentLoop İzleme derin bağlantıları şu anda milisaniye düzeyinde Unix zaman damgaları kullanır. Aktarılmazsa varsayılan değer mevcut zamandan bir saat öncesidir.
`endTime`	Hayır	Sorgu bitiş zamanı. AgentLoop İzleme derin bağlantıları şu anda milisaniye düzeyinde Unix zaman damgaları kullanır. Aktarılmazsa varsayılan değer mevcut zamandır.

Oturum Gezgini'ni açın

const targetUrl = new URL(
  'https://agentloop4service.console.alibabacloud.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/llm_agent/app-list'
);

targetUrl.searchParams.set('targetPage', 'session-explorer');
targetUrl.searchParams.set(
  'filters',
  'attributes.gen_ai.session.id: "{sessionId}"'
);
targetUrl.searchParams.set('queryTimeType', '99');
targetUrl.searchParams.set('startTime', '{startTime}');
targetUrl.searchParams.set('endTime', '{endTime}');

Parametre açıklamaları:

Parametre	Gerekli	Açıklama
`targetPage`	Evet	`session-explorer` olarak ayarlayın.
`filters`	Hayır	Oturum veya İzleme filtre ifadesi
`queryString`	Hayır	İç sorgu sayfasına doğrudan aktarılan sorgu deyimi
`queryTimeType`	Hayır	Aşağı akış sayfasının zaman modu. AgentLoop dahili derin bağlantıları şu anda `99` değerini `startTime` ve `endTime` ile birlikte aktarır.
`startTime`	Hayır	Sorgu başlangıç zamanı. AgentLoop Oturum derin bağlantıları şu anda saniye düzeyinde Unix zaman damgaları kullanır.
`endTime`	Hayır	Sorgu bitiş zamanı. AgentLoop Oturum derin bağlantıları şu anda saniye düzeyinde Unix zaman damgaları kullanır.

Oturum derin bağlantıları saniye düzeyinde zaman damgaları kullanırken İzleme derin bağlantıları milisaniye düzeyinde zaman damgaları kullanır; bu nedenle açtığınız sayfaya göre zaman değerlerini dönüştürün. Tüm hizmet adlarını, veri kümesi adlarını, sorgu deyimlerini ve filtre ifadelerini URLSearchParams ile kodlayın.

İzleme bileşeni rota uyumluluk parametreleri

Dağıtılan dinamik modül /app/llm_agent/trace-detail kaydettiğinde, bu bileşen rotası aşağıdaki parametreleri ayrıca destekler:

Parametre	Gerekli	Açıklama
`traceId` / `traceid`	Evet	İzleme kimliği. Bileşen rotası küçük harfli yazımı da kabul eder.
`startTime`	Hayır	Saniye veya milisaniye düzeyinde zaman damgalarını destekler.
`endTime`	Hayır	Saniye veya milisaniye düzeyinde zaman damgalarını destekler.
`spanId`	Hayır	Span kimliğini belirtin
`initialTab`	Hayır	İzleme ayrıntıları sayfasındaki başlangıç sekmesi
`querySource`	Hayır	İzleme sorgusu kaynak tanımlayıcısı
`source`	Hayır	Sayfa kaynak tanımlayıcısı
`spanFiltersQuery`	Hayır	Span ayrıntısı filtre koşulları
`spanFiltersTimeSeriesQuery`	Hayır	Span zaman serisi filtre koşulları

/app/llm_agent/app-list ana girişi bu gelişmiş parametrelerin tümünü iletmez. Kararlı ve birleşik bir giriş için ana girişin desteklediği yalnızca traceId, startTime ve endTime parametrelerini kullanın.

Entegrasyon Merkezi sayfası

Entegrasyon Merkezi sayfa yolu şudur:

https://agentloop4service.console.alibabacloud.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/integratingcenter

Gömülü parametreleri ihtiyaca göre birleştirebilirsiniz, örneğin:

https://agentloop4service.console.alibabacloud.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/integratingcenter?hiddenSwitch=true&hiddenBackHome=true&embed=%7B%22sidebar%22%3A%22hidden%22%2C%22header%22%3A%22hidden%22%7D

Entegrasyon en iyi uygulamaları

Oturum açma gerektirmeyen bağlantıları sunucu tarafında oluşturun: AssumeRole, GetSigninToken ve son Login URL'nin tamamı sunucu tarafında tamamlanmalıdır. Tarayıcı ön ucu yalnızca son erişilebilir iframe URL'sini alır.
Her zaman 4service etki alanını kullanın: Destination değeri agentloop4service.console.alibabacloud.com etki alanını kullanmalıdır.
URL kodlamasını doğru şekilde işleyin: Destination kendisi sorgu parametreleri içerebilir ve Login URL'ye yazılırken tamamen kodlanmalıdır. Oluşturma işlemi için URL ve URLSearchParams kullanın.
Konsol gezinmesini ihtiyaca göre gizleyin: Harici sistem zaten gezinme sağlıyorsa embed={"sidebar":"hidden","header":"hidden"}, hiddenSwitch=true ve hiddenBackHome=true kombinasyonunu kullanın.
Oturum açma gerektirmeyen bağlantı süresini kontrol edin: Iframe içindeki sayfanın oturum durumu sona erdiği için erişilemez hale gelmesini önlemek amacıyla SigninToken süresi dolmadan önce oturum açma gerektirmeyen bağlantıyı yenileyin.
En az ayrıcalık yetkilendirmesi: RAM rol izinleri, iş gereksinimlerine göre gerekli AgentLoop, günlük kaydı ve gözlemlenebilirlik kaynaklarıyla sınırlandırılmalıdır.

Parametre ayrıştırma ve uyumluluk kuralları

embed geçerli bir JSON olmalıdır. Ayrıştırma başarısız olursa tüm embed yapılandırması yoksayılır.
embed , mevcut sayfanın yaşam döngüsü sırasında yalnızca bir kez ayrıştırılır. Parametre değiştirildikten sonra sayfayı yeniden yükleyin.
Tanınmayan embed alanlarının etkisi yoktur.
Dahili gezinme, embed, hiddenSwitch ve hiddenBackHome parametrelerini korur.
URL parametreleri yalnızca görüntülemeyi ve başlangıç durumunu kontrol eder. Erişim kontrolü sağlamazlar ve bir menüyü veya üstbilgiyi gizlemek RAM, AgentSpace veya veri izni doğrulamasının yerine geçmez.
Tüm kullanıcı girdilerini, hizmet adlarını, veri kümesi adlarını, sorgu deyimlerini ve filtre ifadelerini URLSearchParams ile kodlayın.
Bu belgede listelenmeyen sorgu parametreleri ve çalışma zamanı alanları genel entegrasyon protokolünün parçası değildir. Bunları kendiniz birleştirmeyin ve çevrimiçi belgelere eklemeyin.

SSS

Sorun	Sorun Giderme
Iframe'de oturum açılmadı gösteriliyor	`agentloop4service.console.alibabacloud.com` kullanıldığını ve `Destination` değerinin tamamen URL kodlandığını onaylayın.
Iframe'de izin yok gösteriliyor	RAM rol izinlerinin hedef AgentSpace'i ve ilişkili kaynakları kapsadığını onaylayın.
Kullanıcı AgentSpace değiştirebiliyor	URL'ye `hiddenSwitch=true` parametresini ekleyin.
Kullanıcı AgentLoop ana sayfasına dönebiliyor	URL'ye `hiddenBackHome=true` parametresini ekleyin.
Sol taraf gezinmesi hala görüntüleniyor	`embed` değerinin geçerli bir JSON olduğunu, doğru şekilde URL kodlandığını ve `{"sidebar":"hidden"}` içerdiğini onaylayın.
Sayfa üstbilgisi hala görüntüleniyor	`embed` değerinin `{"header":"hidden"}` içerdiğini onaylayın. `hideHeader=true` kullanmayın.
`hiddenSwitch=false` aktarıldıktan sonra değiştirme girişi hala gizli	Bu parametre varlığına göre değerlendirilir. Girişi geri yüklemek için parametreyi URL'den kaldırın.
Görev oluşturma formu otomatik olarak açılmıyor	`action=create` kullanın. `embed.eval` yalnızca formu önceden doldurur.
Değerlendirme görevi oluşturulurken hizmet adı önceden doldurulmuyor	`app/evaluate-task` sayfasına girildiğini ve `embed.eval.serviceName` karşılık gelen hizmet adının mevcut olduğunu onaylayın.
AI Agent sayfasında oturum açılmıyor	Mevcut giriş olan `app/llm_agent/app-list` kullanın ve `targetPage=session-explorer` parametresini aktarın.
`embed` değiştirildikten sonra sayfa değişmiyor	Yapılandırma yalnızca bir kez ayrıştırılır. URL değiştirildikten sonra sayfayı yeniden yükleyin.

AgentLoop:AgentLoop Konsol Gömülü Paylaşım Entegrasyon Kılavuzu

Genel Bakış

Sayfa URL biçimi

Oturum açma gerektirmeyen bağlantılar oluşturun

Adım 1: Destination oluşturun

Adım 2: Geçici kimlik bilgilerini alın

Adım 3: SigninToken alın

Adım 4: Oturum açma gerektirmeyen bağlantı oluşturun

Gömülü parametreler

embed

hiddenSwitch

hiddenBackHome

Önerilen parametre kombinasyonları

Sol taraf gezinmesini gizleyin

Sayfa üstbilgisini gizleyin

Hem sol taraf gezinmesini hem de sayfa üstbilgisini gizleyin

Alan değiştirmeyi ve ana sayfaya dönüşü devre dışı bırakın

Gezinmeyi gizleyin ve değerlendirme görevi parametrelerini önceden doldurun

Değerlendirme analiz içgörüsü sayfasını basitleştirin

Değerlendirme sayfası parametreleri

Görev oluşturma formunu otomatik olarak açın

Görev düzenleme formunu açın

Görev ayrıntılarını açın

Değerlendirme analiz içgörüsünün başlangıç durumunu ayarlayın

AI Agent Gözlemlenebilirliği sayfası

Uygulama listesini açın

İzleme ayrıntılarını açın

Oturum Gezgini'ni açın

İzleme bileşeni rota uyumluluk parametreleri

Entegrasyon Merkezi sayfası

Entegrasyon en iyi uygulamaları

Parametre ayrıştırma ve uyumluluk kuralları

SSS