AI代理开发工具包

人工智能代理研讨会——入门工具包（Docker）

你只需要。（笑）。。

• Docker：https://www.docker.com/products/docker-desktop/
• Visual Studio代码：https://code.visualstudio.com/
• 开发容器插件： ms-vscode-remote-vscode-mote-expansion back

结构

• data/images/... 带有GroundTruth的集装箱和车牌的合成图像 data/csv/*_labels.csv.
• data/csv/stock_supplies.csv y planned.csv / delivered.csv 对于项目2和3。
• tests/ 模板 pytest 按项目划分。
• src/ 存根：将您的逻辑添加到 src/_student_solutions 以及每个项目的模块。
• compose/ Docker-为当地环境创作。
• Makefile 有捷径。

快速使用

make up             # solo Ollama
make up-full        # Ollama + Open WebUI
make pull-models    # descarga modelos (ajusta a tu GPU)
make test           # ejecuta tests (algunos se marcarán como skip hasta implementar)

API Gemma3+开放式WebUI

• POST /chat：指向Ollama的纯文本代理。
• POST /agent/chat：暴露使用Gemma3的Crewai代理(ollama)和工具 01_container_ref_extractor 从图像中提取代码 image_base64 哦 image_url.
• 环境变量： OLLAMA_URL, OLLAMA_MODEL （默认） gemma3:latesty OLLAMA_TIMEOUT.

学生要执行的任务

• OCR+正则表达式→ src/_student_solutions/ocr_stub.py
• 库存规则→自有模块 src/02_stock
• 计划/交付的合并→自有模块 src/03_planning
• API 扩展 src/04_api/main.py

OpenAPI开发容器工具

• 图像包括 @redocly/openapi-cli 验证/预览规格（openapi lint docs/openapi.yaml, openapi preview-docs docs/openapi.yaml --port 8080).
• 您可以使用 openapi-python-client generate --path docs/openapi.yaml 加快MCP工具的创建。
• 执行 swagger-ui-watcher docs/openapi.yaml --port 8081 在开发工具时在本地浏览Swagger文档。