iblai-vibe-agent-api

用途

iblai-vibe-agent-api 用于在 Next.js 应用中添加“智能体 API”标签页，该标签页负责管理用于程序化访问智能体的 API 密钥。它属于更广泛的智能体设置（agent-settings）系列中的一个标签页，所有标签页共享同一个 AgentSettingsProvider 包装器。

主要能力

以表格形式展示已有的 API 密钥，包含名称、创建时间、过期时间等字段。
提供创建和删除 API 密钥的操作。
支持通过 labels 属性覆盖用户可见的文案。

使用方式

前置条件

必须先完成认证设置（/iblai-vibe-auth）。
需配置 MCP 服务器与技能（在 .mcp.json 中配置 @iblai/mcp）。
AgentSettingsProvider 必须包裹路由（若尚未设置，参见 /iblai-vibe-agent-setting 第 2 步）。
需要向用户询问真实的 mentorId（智能体 UUID），不要自行编造。

第 1 步：检查环境

在继续之前，检查项目根目录下是否存在 iblai.env，并查找 PLATFORM、DOMAIN 和 TOKEN 变量。如果文件不存在或缺少这些变量，需告知用户下载模板并填写值：

curl -o iblai.env https://raw.githubusercontent.com/iblai/vibe/refs/heads/main/iblai.env

第 2 步：挂载 AgentApiTab

// app/(app)/agents/[mentorId]/api/page.tsx
"use client";

import { AgentApiTab } from "@iblai/iblai-js/web-containers/next";

export default function AgentApiPage() {
  return (
    <div className="flex h-full flex-col bg-white">
      <AgentApiTab />
    </div>
  );
}

第 3 步：自定义文案（可选）

import { AgentApiTab } from "@iblai/iblai-js/web-containers/next";

<AgentApiTab
  labels={{
    header: { title: "Mentor API keys" },
  }}
/>;

第 4 步：使用 MCP 工具进行自定义

get_component_info("AgentApiTab")
get_component_info("AgentSettingsProvider")

AgentApiTab 属性

从 @iblai/iblai-js/web-containers/next 导入。

属性	类型	必填	说明
labels	DeepPartial<ApiTabLabels>	否	覆盖用户可见的字符串

第 5 步：验证

在告知用户工作已就绪之前，运行 /iblai-vibe-ops-test：

pnpm build —— 必须零错误通过。
pnpm test —— vitest 必须通过。
启动开发服务器并进行触测：

pnpm dev &
npx playwright screenshot http://localhost:3000/agents/<id>/api /tmp/agent-api.png

重要说明

Redux store：必须包含 mentorReducer 和 mentorMiddleware。
initializeDataLayer()：需要 5 个参数（v1.2+）。
@reduxjs/toolkit：通过 next.config.ts 中的 webpack 别名去重。
对等依赖：必须安装 sonner 和 @iblai/iblai-web-mentor（pnpm add sonner @iblai/iblai-web-mentor）。
共享 provider：AgentSettingsProvider 必须在布局层级包裹路由。完整代码片段参见 /iblai-vibe-agent-setting 第 2 步。
品牌指南：BRAND.md。

适用场景

适用于需要在 Next.js 应用中为智能体提供 API 密钥管理界面的开发者，尤其是使用 iblai 平台并希望以程序化方式访问智能体的场景。

限制

依赖认证、MCP 配置和 AgentSettingsProvider 等前置条件。
需要真实的 mentorId，不能编造。
关于收费、价格、平台支持范围等信息，资料中暂未提供。

技能介绍

用途