usehook - 前端码易

创建时间: 2026-08-12最后更新: 2026-08-12作者: yangbo(445bdcbd2)

1. 什么是 AI Agent

我们常说的 Agent 是对于大模型（LLM）对话能力的封装。

Agent 的复杂度，会按照如下几个方向，进行演变

从单次对话，到多次对话、
从短期对话，到长期对话、
从有回应，到有更好的回应
从单角色，到多角色对话、

而我们的速成学习法，也是围绕这个方向进行展开。因此，这一章，我们要要掌握的，就是我们最熟悉的最常见的一种场景：跟 LLM 单次对话

单次对话

如下案例所示，我这里实现了一个最简单 Agent. 在此 Agent 中，我没有做任何处理，直接跟大语言模型进行对话，通俗来说就是直接调用大语言模型的 API，我的第一个需求是：「明天出门我应该带什么？」

出行规划 AgentLangChain + DeepSeek

agent.ts

chat-demo.tsx

01import { readRequiredActiveLlmConfig } from '@keepzml/llm-runtime/client'
02import { createChatModel } from '@keepzml/llm-runtime/model'
03
04export interface AgentReplyChunk {
05  content: string
06  model: string
07}
08
09export interface AgentMessage {
10  role: 'user' | 'assistant'
11  content: string
12}
13
14export async function* runTravelAgent(
15  messages: readonly AgentMessage[],
16  abortSignal?: AbortSignal,
17): AsyncGenerator<AgentReplyChunk> {
18  const config = await readRequiredActiveLlmConfig()
19  const model = await createChatModel(config, {
20    temperature: config.temperature ?? 0,
21    thinkingIntensity: 'off',
22  })
23
24  const stream = await model.stream([
25    [
26      'system',
27      `你是一个谨慎的出行规划 Agent。你的目标是根据用户的目的地、行程、天气和个人习惯，给出可靠的出行准备建议`,
28    ],
29    ...messages.map(message => ({
30      role: message.role,
31      content: message.content,
32    })),
33  ], { signal: abortSignal })
34
35  let hasContent = false
36
37  for await (const chunk of stream) {
38    const content = readTextContent(chunk.content)
39    if (!content) continue
40
41    hasContent = true
42    yield {
43      content,
44      model: config.model,
45    }
46  }
47
48  if (!hasContent) throw new Error('模型没有返回可显示的文字内容')
49}
50
51function readTextContent(content: unknown) {
52  if (typeof content === 'string') return content
53  if (!Array.isArray(content)) return ''
54
55  const text = content
56    .map((part) => {
57      if (typeof part === 'string') return part
58      if (
59        part
60        && typeof part === 'object'
61        && 'text' in part
62        && typeof part.text === 'string'
63      ) {
64        return part.text
65      }
66      return ''
67    })
68    .filter(Boolean)
69    .join('\n')
70
71  return text
72}
73