sanbuphy
0eba9e87e9
- Disable formatting rules (handled by Prettier) - Relaxed strict Vue/JS rules for demo code compatibility - Fix syntax errors in ApiPlayground and VoiceCloningDemo - Fix duplicate else-if condition in ApiPlayground - Fix Promise executor async pattern in AutoregressiveAudioDemo - Add TypeScript file support to ESLint config Warnings reduced from 295 to 251 problems. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
613 lines
13 KiB
Vue
613 lines
13 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 }]"
|
||
/>
|
||
</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: 6px;
|
||
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: 6px;
|
||
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: 6px;
|
||
font-size: 12px;
|
||
color: var(--vp-c-text-1);
|
||
}
|
||
</style>
|