chatkit

欢迎语与推荐问题

空会话默认显示欢迎内容；推荐问题需要通过 settings.recommendations 提供，点选后直接尝试发送。示例左侧展示完整源码，右侧可以点击推荐问题体验。

welcome.tsx
import { Chatkit, useChatRuntime } from '@volcengine/chatkit';
import { createMockAdapter } from '@volcengine/chatkit/adapters/mock';
import '@volcengine/chatkit/styles.css';

const adapter = createMockAdapter({});

// 空会话时的欢迎语与推荐问题：点一条推荐问题直接发出。
export default function Welcome() {
  const runtime = useChatRuntime({ sessionId: 'welcome', adapter });
  if (!runtime) return null;
  return (
    <Chatkit
      runtime={runtime}
      settings={{
        welcome: '有什么可以帮忙的？',
        recommendations: ['帮我查一下 chatkit 怎么接入', '把这段需求整理成待办清单', '解释一下什么是 RAG'],
        placeholder: '问点什么，或者从上面挑一个开始',
      }}
    />
  );
}
空会话的欢迎语与推荐问题新窗口打开

只设置推荐问题、不设置 welcome 时，空会话只显示推荐问题。需要两者同时显示时显式提供欢迎语。推荐问题直接调用发送入口，不会附带或清空输入框中的草稿和附件，也不受 composer.hidden / disabled 约束；统一拦截发送可用 onSend。若希望用户先编辑问题再发送，使用输入建议：它只填入草稿，不直接发送。

配置项

配置项类型默认说明
settings.welcomestring—空会话的欢迎语。
settings.recommendationsreadonly string[]—推荐问题，点一条直接发出。

需要改变空会话的内容、顶部／居中位置或输入框摆放时，参见定制空会话内容与位置，那里有可切换的在线示例和完整源码。