AgentLoop:Panduan Integrasi Penyematan Berbagi Konsol AgentLoop

Langkah 1: Buat Tujuan

Destination adalah halaman AgentLoop yang akan dibuka pengguna setelah otentikasi tanpa login.

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}',
    },
  })
);

Langkah 2: Dapatkan kredensial sementara

Server sistem pihak ketiga memanggil STS AssumeRole untuk mendapatkan kredensial sementara. Konfigurasikan hak istimewa minimal berdasarkan cakupan pengguna, penyewa, atau resource bisnis. Token hanya dapat digunakan sekali. Untuk detailnya, lihat AssumeRole.

Parameter umum:

Jangan menyimpan atau mengirim AccessKey jangka panjang di frontend browser.

Langkah 3: Dapatkan SigninToken

Panggil Single Sign-On (SSO) RAM untuk mendapatkan SigninToken. Format tautannya sebagai berikut. Catatan: TicketType harus diatur ke mini.

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

Untuk menghindari pengeksposan informasi sensitif, GetSigninToken hanya boleh dipanggil di sisi server. Jangan menggabungkan atau mengekspos kunci sementara di frontend browser.

Langkah 4: Hasilkan tautan tanpa login

Tambahkan SigninToken yang dikembalikan ke tautan yang telah disiapkan untuk menghasilkan tautan akses tanpa kata sandi.

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());

Format URL akhir:

http://signin.alibabacloud.com/federation?Action=Login
                            &LoginUrl=<Alamat untuk dialihkan saat login kedaluwarsa, biasanya dikonfigurasi sebagai URL yang melakukan pengalihan 302 di layanan web kustom Anda. Gunakan encodeURL untuk meng-encode LoginUrl.>
                            &Destination=<Halaman aktual yang akan diakses. Jika ada parameter, gunakan encodeURL untuk meng-encode-nya.>
                            &SigninToken=<Token login yang diperoleh. Gunakan encodeURL untuk meng-encode token tersebut.>

Contoh iframe:

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

embed

embed digunakan untuk meneruskan konfigurasi penyematan terstruktur sebagai string JSON. Saat ditambahkan ke URL, nilai ini harus di-URL-encode.

Bentuk yang mudah dibaca:

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

Definisi struktur:

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;
      };
    };
  };
}

Deskripsi parameter:

timeRange.from harus lebih kecil dari timeRange.to, dan kedua nilai menggunakan timestamp Unix tingkat detik. embed.eval hanya pratata formulir buat tugas; tidak membuka formulir secara otomatis.

Contoh pembuatan:

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());

Contoh URL yang dihasilkan:

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

Menyembunyikan entri pengalihan AgentSpace.

hiddenSwitch=true

Jika sistem pihak ketiga telah menetapkan AgentSpace saat ini, aktifkan parameter ini untuk mencegah pengguna beralih ke ruang lain dalam halaman tersemat.

hiddenBackHome

Menyembunyikan entri "Kembali ke Beranda".

hiddenBackHome=true

Jika sistem pihak ketiga ingin pengguna tetap berada di halaman AgentSpace yang ditentukan, aktifkan parameter ini untuk mencegah pengguna kembali ke halaman utama AgentLoop.

hiddenSwitch dan hiddenBackHome dievaluasi hanya berdasarkan keberadaannya. Bahkan jika nilainya false, parameter tetap berlaku selama muncul di URL. Untuk mengembalikan entri pengalihan AgentSpace atau entri halaman utama, hapus parameter yang sesuai dari URL.

Sembunyikan navigasi sisi kiri

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

Sembunyikan header halaman

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

Sembunyikan navigasi sisi kiri dan header halaman

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

Nonaktifkan pengalihan ruang dan kembali ke beranda

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

Sembunyikan navigasi dan pratata parameter tugas evaluasi

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

Sederhanakan halaman Evaluation analysis insights

Menghasilkan alamat dengan API browser standar menghindari penanganan manual JSON, spasi, dan tanda kutip:

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());

Buka formulir buat tugas secara otomatis

Jalur halaman:

/app/evaluate-task

Deskripsi parameter:

Contoh:

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}');

Setelah halaman menggunakan parameter satu kali ini, action, dataSource, dan datasetName dihapus dari bilah alamat sehingga refresh tidak memicu formulir lagi.

Buka formulir edit tugas

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

editTaskId juga dihapus dari bilah alamat setelah digunakan.

Buka detail tugas

Jalur halaman:

/app/evaluate-task-detail

Deskripsi parameter:

Atur keadaan awal wawasan analisis Evaluasi

Jalur halaman:

/app/explorer

Deskripsi parameter:

Contoh:

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');

Saat agregasi tidak diperlukan, abaikan groupBy dan subGroupBy atau atur nilainya ke none.

Buka daftar aplikasi

Saat baik traceId maupun targetPage tidak diteruskan, halaman membuka daftar aplikasi.

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

Buka Detail Trace

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

Deskripsi parameter:

Buka Session Explorer

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}');

Deskripsi parameter:

Tautan dalam Sesi menggunakan timestamp tingkat detik sedangkan tautan dalam Trace menggunakan timestamp tingkat milidetik, jadi konversi nilai waktu sesuai dengan halaman yang Anda buka. Encode semua nama layanan, nama dataset, pernyataan kueri, dan ekspresi filter dengan URLSearchParams.

Parameter kompatibilitas entri rute komponen Trace

Saat modul dinamis yang dideploy mendaftarkan /app/llm_agent/trace-detail, entri rute komponen tersebut juga mendukung parameter berikut:

Entri utama /app/llm_agent/app-list tidak meneruskan semua parameter lanjutan ini. Untuk entri yang stabil dan terpadu, gunakan hanya traceId, startTime, dan endTime, yang didukung oleh entri utama.