AIBasicFinalProject

GlideHoop 用户手册 (English is not supported yet)

还在维护中!将尽快完善

ADK WEB 的使用方式

影片分析功能使用指南

影片上传

basketball_coach/   
├── resource/       
│   ├── videos/     <-- 在此目录上传您的视频(目录会自动创建)  
│   └── html/            
├── __init__.py        
└── agent.py                    

影片分析

在对话中,需要明确交代待分析的影片的档案名称。你可以透过提问如“目前我都上传了哪些影片”来让Agent返回档案名称。

我们支持三种分析:球队球员构成、得分、违例违规(如果没有指定的话,Agent会自动生成一个包含三样内容的概括性分析)

注意:目前的生成结果并不完全可靠,尤其容易混淆球员,需要人工检查。在判断得分时间戳上相对可靠。

战术生成功能使用指南

生成战术

默认前置要求

需要您提供至少五位球员的基本信息(姓名、球号、位置),可以直接键入或来自球员数据库,否则Agent会辅助你完成资料的建立

跳过前置要求

您可以向她明确说明“随机分配xx部分的内容”,来跳过资料设置的步骤

战术可视化

启用可视化

在对话中,明确指出需要可视化即可

结果保存

basketball_coach/   
├── resource/       
│   ├── videos/         
│   └── html/       <-- 在此目录可以看到战术板生成结果(目录会自动创建)   
├── __init__.py        
└── agent.py                    

球员资料库维护指南

本指南将帮助您理解和维护本地存储的球员信息资料库。您的篮球教练 AI 助手能够与这个资料库交互,实现球员信息的查询、添加、更新和删除。

1. 资料库概览

您的球员资料库以 JSON 文件 的形式存储在本地文件系统中。这是一种轻量级、人类可读的数据格式,非常适合作为本地应用的数据存储。

资料库文件路径:

您的球员资料库文件位于项目根目录下的 data/ 文件夹内,文件名为 players.json

例如:your_project_folder/data/players.json

basketball_coach/   
├── data/       
│   └── players.json      <-- 您的资料库
├── __init__.py        
└── agent.py                    

2. 资料库结构与字段定义

players.json 文件是一个 JSON 数组,其中每个元素都是一个代表球员信息的 JSON 对象。每个球员对象包含以下字段:

示例 players.json 结构:

[
    {
        "player_name": "Lionel Messi",
        "player_position": "Forward",
        "playing_style": "Playmaker",
        "jersey_number": 10,
        "team": "Inter Miami CF",
        "age": 37,
        "nationality": "Argentina",
        "skill_rating": 98,
        "notes": "Arguably the greatest player of all time."
    },
    {
        "player_name": "Cristiano Ronaldo",
        "player_position": "Forward",
        "playing_style": "Attacking",
        "jersey_number": 7,
        "team": "Al Nassr FC",
        "age": 39,
        "nationality": "Portugal",
        "skill_rating": 95,
        "notes": "Prolific goal scorer."
    }
]

3. 通过 AI 助手维护资料库(推荐方式)

强烈建议您通过与篮球教练 AI 助手进行对话来维护球员资料库。AI 助手会调用内置工具安全地执行操作,并提供友好的反馈。

自然语言命令示例

查询操作
添加操作
更新操作
删除操作

交互反馈机制

操作成功反馈
格式:"[操作类型] '球员姓名' 已成功[动作]资料库。"
示例:"添加 '孙兴慜' 已成功添加到资料库。"

操作失败反馈
格式:"错误: [失败原因]。[修正建议]"
示例:
"错误: 未找到球员'Cristiano Ronaldo'。请检查姓名是否正确。"
"错误: 球员'李明'已存在。请使用更新操作或更改姓名。"


待修复的问题