docs: update content and components across multiple files
- Refine chapter introductions in zh-cn docs for clarity and conciseness - Update navigation links to include '/easy-vibe' prefix - Simplify UI components (ChapterIntroduction, ContextWindowVisualizer) - Add new agent-related demo components (AgentMemoryDemo, AgentToolUseDemo) - Improve context compression demo with better visuals and metrics - Adjust styling and layout across various components
This commit is contained in:
sanbuphy
@@ -0,0 +1,520 @@
|
||||
<template>
|
||||
<div class="tool-use-demo">
|
||||
<div class="header">
|
||||
<div class="title">🔧 揭秘：Agent 如何调用工具？</div>
|
||||
</div>
|
||||
|
||||
<!-- 场景选择 -->
|
||||
<div class="scenario-tabs">
|
||||
<button
|
||||
v-for="s in scenarios"
|
||||
:key="s.id"
|
||||
:class="['tab-btn', { active: currentScenario === s.id }]"
|
||||
@click="selectScenario(s.id)"
|
||||
>
|
||||
<span>{{ s.icon }}</span>
|
||||
<span>{{ s.name }}</span>
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<!-- 用户输入 -->
|
||||
<div class="user-input-bar">
|
||||
<span class="label">👤</span>
|
||||
<span class="text">"{{ currentData.userInput }}"</span>
|
||||
</div>
|
||||
|
||||
<!-- 横向流程 -->
|
||||
<div ref="flowRowRef" class="flow-row">
|
||||
<!-- 步骤1: 理解 -->
|
||||
<div class="flow-card" :class="{ active: currentStep >= 1 }">
|
||||
<div class="card-num">1</div>
|
||||
<div class="card-body">
|
||||
<div class="card-title">分析需求</div>
|
||||
<div v-if="currentStep >= 1" class="card-content">
|
||||
<div class="intent-box">
|
||||
<div class="intent-label">用户想要：</div>
|
||||
<div class="intent-value">{{ currentData.intent.type }}</div>
|
||||
</div>
|
||||
<div class="extract-box">
|
||||
<div class="extract-label">提取信息：</div>
|
||||
<div class="extract-tags">
|
||||
<span v-for="(e, i) in currentData.intent.entities" :key="i" class="entity">{{ e }}</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="flow-arrow" :class="{ active: currentStep >= 2 }">→</div>
|
||||
|
||||
<!-- 步骤2: 选工具 -->
|
||||
<div class="flow-card" :class="{ active: currentStep >= 2 }">
|
||||
<div class="card-num">2</div>
|
||||
<div class="card-body">
|
||||
<div class="card-title">选择工具</div>
|
||||
<div v-if="currentStep >= 2" class="card-content">
|
||||
<div class="tool-list">
|
||||
<div
|
||||
v-for="tool in currentData.availableTools.slice(0, 2)"
|
||||
:key="tool.name"
|
||||
class="tool-mini"
|
||||
:class="{ selected: tool.selected }"
|
||||
>
|
||||
<span>{{ tool.icon }}</span>
|
||||
<span class="tool-name">{{ tool.name }}</span>
|
||||
<span v-if="tool.selected" class="check">✓</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="flow-arrow" :class="{ active: currentStep >= 3 }">→</div>
|
||||
|
||||
<!-- 步骤3: 构造参数 -->
|
||||
<div class="flow-card" :class="{ active: currentStep >= 3 }">
|
||||
<div class="card-num">3</div>
|
||||
<div class="card-body">
|
||||
<div class="card-title">构造参数</div>
|
||||
<div v-if="currentStep >= 3" class="card-content">
|
||||
<code class="params-code">{{ JSON.stringify(currentData.finalParams.params) }}</code>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="flow-arrow" :class="{ active: currentStep >= 4 }">→</div>
|
||||
|
||||
<!-- 步骤4: 执行 -->
|
||||
<div class="flow-card" :class="{ active: currentStep >= 4 }">
|
||||
<div class="card-num">4</div>
|
||||
<div class="card-body">
|
||||
<div class="card-title">执行返回</div>
|
||||
<div v-if="currentStep >= 4" class="card-content">
|
||||
<div class="exec-flow">
|
||||
<span class="from">Agent</span>
|
||||
<span class="arrow">→</span>
|
||||
<span class="to">{{ currentData.selectedTool }}</span>
|
||||
<span class="arrow">→</span>
|
||||
<span class="from">结果</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 最终结果 -->
|
||||
<div v-if="currentStep >= 4" class="final-result">
|
||||
<span class="result-label">💬 回复：</span>
|
||||
<span class="result-text">{{ currentData.finalResponse }}</span>
|
||||
</div>
|
||||
|
||||
<!-- 控制栏 -->
|
||||
<div class="control-bar">
|
||||
<button v-if="currentStep === 0" class="ctrl-btn primary" @click="nextStep">
|
||||
▶ 开始演示
|
||||
</button>
|
||||
<button v-else-if="currentStep < 4" class="ctrl-btn primary" @click="nextStep">
|
||||
下一步 →
|
||||
</button>
|
||||
<button v-else class="ctrl-btn" @click="reset">
|
||||
🔄 重置
|
||||
</button>
|
||||
|
||||
<div class="step-dots">
|
||||
<span v-for="n in 4" :key="n" :class="['dot', { active: currentStep >= n }]"></span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 提示 -->
|
||||
<div class="tip-bar">
|
||||
<span>💡</span>
|
||||
<span>Tool Calling 本质：LLM 生成结构化文本（JSON），外部系统执行后返回结果</span>
|
||||
</div>
|
||||
</div>
|
||||
</template>
|
||||
|
||||
<script setup>
|
||||
import { ref, computed, watch, nextTick } from 'vue'
|
||||
|
||||
const scenarios = [
|
||||
{
|
||||
id: 'weather',
|
||||
icon: '🌤️',
|
||||
name: '查天气',
|
||||
userInput: '明天上海需要带伞吗？',
|
||||
intent: { type: '天气查询', entities: ['明天', '上海'], confidence: 95 },
|
||||
availableTools: [
|
||||
{ name: 'weather_api', icon: '🌤️', description: '获取天气', selected: true, score: 95 },
|
||||
{ name: 'calculator', icon: '🧮', description: '数学计算', selected: false, score: 10 },
|
||||
],
|
||||
selectedTool: 'weather_api',
|
||||
finalParams: { tool: 'weather_api', params: { city: '上海', date: 'tomorrow' } },
|
||||
finalResponse: '明天上海有小雨，建议带伞。气温 8-15°C。'
|
||||
},
|
||||
{
|
||||
id: 'calculate',
|
||||
icon: '🧮',
|
||||
name: '计算',
|
||||
userInput: '1250 除以 25 乘以 8 等于多少',
|
||||
intent: { type: '数学计算', entities: ['1250', '25', '8'], confidence: 98 },
|
||||
availableTools: [
|
||||
{ name: 'weather_api', icon: '🌤️', description: '获取天气', selected: false, score: 5 },
|
||||
{ name: 'calculator', icon: '🧮', description: '数学计算', selected: true, score: 98 },
|
||||
],
|
||||
selectedTool: 'calculator',
|
||||
finalParams: { tool: 'calculator', params: { expression: '(1250/25)*8' } },
|
||||
finalResponse: '计算结果：400。'
|
||||
},
|
||||
{
|
||||
id: 'search',
|
||||
icon: '🔍',
|
||||
name: '搜索',
|
||||
userInput: '搜索最近关于人工智能的新闻',
|
||||
intent: { type: '信息检索', entities: ['AI', '新闻'], confidence: 92 },
|
||||
availableTools: [
|
||||
{ name: 'web_search', icon: '🔍', description: '网络搜索', selected: true, score: 92 },
|
||||
{ name: 'calculator', icon: '🧮', description: '数学计算', selected: false, score: 5 },
|
||||
],
|
||||
selectedTool: 'web_search',
|
||||
finalParams: { tool: 'web_search', params: { query: 'AI news', max: 5 } },
|
||||
finalResponse: '为您找到 5 条最新 AI 新闻...'
|
||||
}
|
||||
]
|
||||
|
||||
const currentScenario = ref('weather')
|
||||
const currentStep = ref(0)
|
||||
|
||||
const currentData = computed(() => scenarios.find(s => s.id === currentScenario.value))
|
||||
|
||||
const selectScenario = (id) => {
|
||||
currentScenario.value = id
|
||||
reset()
|
||||
}
|
||||
|
||||
const flowRowRef = ref(null)
|
||||
|
||||
const nextStep = () => {
|
||||
if (currentStep.value < 4) {
|
||||
currentStep.value++
|
||||
// 自动滚动到当前步骤
|
||||
nextTick(() => {
|
||||
if (flowRowRef.value) {
|
||||
const cards = flowRowRef.value.querySelectorAll('.flow-card')
|
||||
const currentCard = cards[currentStep.value - 1]
|
||||
if (currentCard) {
|
||||
currentCard.scrollIntoView({ behavior: 'smooth', inline: 'center', block: 'nearest' })
|
||||
}
|
||||
}
|
||||
})
|
||||
}
|
||||
}
|
||||
const reset = () => { currentStep.value = 0 }
|
||||
</script>
|
||||
|
||||
<style scoped>
|
||||
.tool-use-demo {
|
||||
background: var(--vp-c-bg-soft);
|
||||
border: 1px solid var(--vp-c-divider);
|
||||
border-radius: 12px;
|
||||
padding: 20px;
|
||||
margin: 20px 0;
|
||||
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
|
||||
}
|
||||
|
||||
.header {
|
||||
text-align: center;
|
||||
margin-bottom: 16px;
|
||||
}
|
||||
|
||||
.title {
|
||||
font-size: 17px;
|
||||
font-weight: 700;
|
||||
background: linear-gradient(120deg, var(--vp-c-brand), #9c27b0);
|
||||
-webkit-background-clip: text;
|
||||
-webkit-text-fill-color: transparent;
|
||||
}
|
||||
|
||||
/* 场景标签 */
|
||||
.scenario-tabs {
|
||||
display: flex;
|
||||
gap: 8px;
|
||||
justify-content: center;
|
||||
margin-bottom: 16px;
|
||||
flex-wrap: wrap;
|
||||
}
|
||||
|
||||
.tab-btn {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 6px;
|
||||
padding: 6px 14px;
|
||||
border: 1px solid var(--vp-c-divider);
|
||||
border-radius: 16px;
|
||||
background: var(--vp-c-bg);
|
||||
cursor: pointer;
|
||||
font-size: 13px;
|
||||
transition: all 0.2s;
|
||||
}
|
||||
|
||||
.tab-btn.active {
|
||||
border-color: var(--vp-c-brand);
|
||||
background: var(--vp-c-brand-soft);
|
||||
color: var(--vp-c-brand-dark);
|
||||
}
|
||||
|
||||
/* 用户输入 */
|
||||
.user-input-bar {
|
||||
background: var(--vp-c-bg);
|
||||
border: 1px solid var(--vp-c-divider);
|
||||
border-radius: 8px;
|
||||
padding: 10px 14px;
|
||||
margin-bottom: 16px;
|
||||
font-size: 14px;
|
||||
}
|
||||
|
||||
.user-input-bar .label { margin-right: 8px; }
|
||||
.user-input-bar .text { font-weight: 600; color: var(--vp-c-text-1); }
|
||||
|
||||
/* 横向流程 */
|
||||
.flow-row {
|
||||
display: flex;
|
||||
align-items: stretch;
|
||||
gap: 8px;
|
||||
margin-bottom: 16px;
|
||||
overflow-x: auto;
|
||||
}
|
||||
|
||||
@media (max-width: 768px) {
|
||||
.flow-row {
|
||||
flex-direction: column;
|
||||
}
|
||||
.flow-arrow {
|
||||
transform: rotate(90deg);
|
||||
}
|
||||
}
|
||||
|
||||
.flow-card {
|
||||
flex: 1;
|
||||
min-width: 140px;
|
||||
background: var(--vp-c-bg);
|
||||
border: 1px solid var(--vp-c-divider);
|
||||
border-radius: 10px;
|
||||
padding: 12px;
|
||||
opacity: 0.4;
|
||||
transition: all 0.3s;
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
}
|
||||
|
||||
.flow-card.active {
|
||||
opacity: 1;
|
||||
border-color: var(--vp-c-brand);
|
||||
box-shadow: 0 2px 8px rgba(0,0,0,0.05);
|
||||
}
|
||||
|
||||
.card-num {
|
||||
width: 22px;
|
||||
height: 22px;
|
||||
border-radius: 50%;
|
||||
background: var(--vp-c-bg-mute);
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
font-size: 11px;
|
||||
font-weight: 700;
|
||||
margin-bottom: 8px;
|
||||
}
|
||||
|
||||
.flow-card.active .card-num {
|
||||
background: var(--vp-c-brand);
|
||||
color: white;
|
||||
}
|
||||
|
||||
.card-title {
|
||||
font-size: 12px;
|
||||
font-weight: 600;
|
||||
margin-bottom: 8px;
|
||||
color: var(--vp-c-text-1);
|
||||
}
|
||||
|
||||
.card-content {
|
||||
font-size: 12px;
|
||||
}
|
||||
|
||||
/* 意图内容 */
|
||||
.intent-box {
|
||||
margin-bottom: 8px;
|
||||
}
|
||||
|
||||
.intent-label {
|
||||
font-size: 10px;
|
||||
color: var(--vp-c-text-2);
|
||||
margin-bottom: 4px;
|
||||
}
|
||||
|
||||
.intent-value {
|
||||
display: inline-block;
|
||||
padding: 4px 10px;
|
||||
background: var(--vp-c-brand-soft);
|
||||
color: var(--vp-c-brand-dark);
|
||||
border-radius: 6px;
|
||||
font-size: 12px;
|
||||
font-weight: 600;
|
||||
}
|
||||
|
||||
.extract-box {
|
||||
margin-top: 8px;
|
||||
}
|
||||
|
||||
.extract-label {
|
||||
font-size: 10px;
|
||||
color: var(--vp-c-text-2);
|
||||
margin-bottom: 4px;
|
||||
}
|
||||
|
||||
.extract-tags {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
gap: 4px;
|
||||
}
|
||||
|
||||
.entity {
|
||||
padding: 3px 8px;
|
||||
background: #fef3c7;
|
||||
border: 1px solid #fde68a;
|
||||
border-radius: 4px;
|
||||
font-size: 11px;
|
||||
color: #92400e;
|
||||
font-weight: 500;
|
||||
}
|
||||
|
||||
/* 工具列表 */
|
||||
.tool-list {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 6px;
|
||||
}
|
||||
|
||||
.tool-mini {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 6px;
|
||||
padding: 6px 8px;
|
||||
background: var(--vp-c-bg-soft);
|
||||
border-radius: 6px;
|
||||
font-size: 11px;
|
||||
}
|
||||
|
||||
.tool-mini.selected {
|
||||
background: #dcfce7;
|
||||
border: 1px solid #86efac;
|
||||
}
|
||||
|
||||
.tool-name { flex: 1; }
|
||||
.check { color: #16a34a; font-weight: 700; }
|
||||
|
||||
/* 参数代码 */
|
||||
.params-code {
|
||||
display: block;
|
||||
background: #1e1e1e;
|
||||
color: #d4d4d4;
|
||||
padding: 8px;
|
||||
border-radius: 6px;
|
||||
font-size: 10px;
|
||||
overflow-x: auto;
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
/* 执行流程 */
|
||||
.exec-flow {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 4px;
|
||||
font-size: 11px;
|
||||
flex-wrap: wrap;
|
||||
}
|
||||
|
||||
.from, .to {
|
||||
padding: 3px 8px;
|
||||
border-radius: 4px;
|
||||
font-weight: 600;
|
||||
}
|
||||
|
||||
.from { background: var(--vp-c-brand-soft); color: var(--vp-c-brand-dark); }
|
||||
.to { background: #fef3c7; color: #92400e; }
|
||||
.arrow { color: var(--vp-c-text-3); }
|
||||
|
||||
/* 箭头 */
|
||||
.flow-arrow {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
color: var(--vp-c-divider);
|
||||
font-size: 18px;
|
||||
transition: all 0.3s;
|
||||
}
|
||||
|
||||
.flow-arrow.active { color: var(--vp-c-brand); }
|
||||
|
||||
/* 最终结果 */
|
||||
.final-result {
|
||||
background: var(--vp-c-brand-soft);
|
||||
border-left: 3px solid var(--vp-c-brand);
|
||||
border-radius: 8px;
|
||||
padding: 12px 14px;
|
||||
margin-bottom: 16px;
|
||||
font-size: 13px;
|
||||
}
|
||||
|
||||
.result-label { font-weight: 600; margin-right: 8px; }
|
||||
.result-text { color: var(--vp-c-text-1); }
|
||||
|
||||
/* 控制栏 */
|
||||
.control-bar {
|
||||
display: flex;
|
||||
justify-content: space-between;
|
||||
align-items: center;
|
||||
margin-bottom: 16px;
|
||||
}
|
||||
|
||||
.ctrl-btn {
|
||||
padding: 8px 18px;
|
||||
border: 1px solid var(--vp-c-divider);
|
||||
border-radius: 6px;
|
||||
background: var(--vp-c-bg);
|
||||
cursor: pointer;
|
||||
font-size: 13px;
|
||||
font-weight: 600;
|
||||
}
|
||||
|
||||
.ctrl-btn.primary {
|
||||
background: var(--vp-c-brand);
|
||||
color: white;
|
||||
border-color: var(--vp-c-brand);
|
||||
}
|
||||
|
||||
.step-dots {
|
||||
display: flex;
|
||||
gap: 6px;
|
||||
}
|
||||
|
||||
.dot {
|
||||
width: 8px;
|
||||
height: 8px;
|
||||
border-radius: 50%;
|
||||
background: var(--vp-c-divider);
|
||||
}
|
||||
|
||||
.dot.active { background: var(--vp-c-brand); }
|
||||
|
||||
/* 提示 */
|
||||
.tip-bar {
|
||||
display: flex;
|
||||
gap: 8px;
|
||||
padding: 10px 14px;
|
||||
background: var(--vp-c-brand-soft);
|
||||
border-radius: 8px;
|
||||
font-size: 12px;
|
||||
color: var(--vp-c-text-1);
|
||||
}
|
||||
</style>
|
||||
Reference in New Issue
Block a user