sanbuphy
e5b1c6cc88
- 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
521 lines
12 KiB
Vue
521 lines
12 KiB
Vue
<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>
|