AgentLoop 控制台内嵌分享接入指南

步骤一：生成 Destination

Destination 是用户免登录后最终打开的 AgentLoop 页面。

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

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

步骤二：获取临时身份

第三方系统服务端调用 STS AssumeRole，获取临时身份。建议按用户、租户或业务资源范围配置最小权限。一个Token只能使用一次，详情可参考AssumeRole - 获取扮演角色的临时身份凭证。

常用参数：

请勿在浏览器前端保存或传输长期 AccessKey。

步骤三：获取 SigninToken

调用RAM单点登录SSO，获取SigninToken。拼接链接的形式如下。注意：TicketType必须指定为mini。

http://signin.aliyun.com/federation?Action=GetSigninToken
                    &AccessKeyId=<STS返回的临时AK>
                    &AccessKeySecret=<STS返回的临时Secret>
                    &SecurityToken=<STS返回的安全Token>
                    &TicketType=mini

为避免泄露敏感信息，GetSigninToken 应仅在服务端调用，不要在浏览器前端拼接或暴露临时密钥。

步骤四：生成免登录链接

将返回的SigninToken拼接到准备好的链接中，生成免密访问链接。

const loginUrl = new URL('https://signin.aliyun.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());

最终 URL 形态：

http://signin.aliyun.com/federation?Action=Login
                            &LoginUrl=<登录失效跳转的地址，一般配置为自建Web配置302跳转的URL。需要使用encodeURL对LoginUrl进行转码。>
                            &Destination=<实际访问页面。如果有参数，则需要使用encodeURL对参数进行转码。>
                            &SigninToken=<获取的登录Token，需要使用encodeURL对Token进行转码。>

iframe 示例：

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

embed

embed 用于传递结构化内嵌配置，值为 JSON 字符串。实际拼接到 URL 时，需要进行 URL 编码。

可读形式：

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

结构说明：

interface EmbedConfig {
  sidebar?: 'hidden';
  eval?: {
    dataSource?: 'trace' | 'log' | 'dataset';
    serviceName?: string;
  };
}

参数说明：

生成示例：

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

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

生成后的 URL 示例：

https://agentloop4service.console.aliyun.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/evaluation?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 切换入口。

hiddenSwitch=true

如果第三方系统已经固定当前 AgentSpace，建议开启该参数，避免用户在内嵌页面中切换到其他空间。

hiddenBackHome

隐藏“返回首页”入口。

hiddenBackHome=true

如果第三方系统只希望用户停留在指定 AgentSpace 页面，建议开启该参数，避免用户返回 AgentLoop 首页。

隐藏左侧导航

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

禁止切换空间和返回首页

https://agentloop4service.console.aliyun.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/overview?hiddenSwitch=true&hiddenBackHome=true

隐藏导航并预填评估任务参数

https://agentloop4service.console.aliyun.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/evaluation?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

打开应用列表

不传 traceId 时，页面默认打开应用列表。

https://agentloop4service.console.aliyun.com/agentloop/region/{regionId}/agentspace/{agentSpaceName}/app/llm-agent?hiddenSwitch=true&hiddenBackHome=true

打开 Trace 详情

传入 traceId 时，页面打开对应 Trace 详情。

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

参数说明：

如果未传 startTime 或 endTime，页面会使用默认时间范围查询。