spring-ai-alibaba-examples

Spring AI Alibaba サンプル

Spring AI Alibaba リポジトリ：https://github.com/alibaba/spring-ai-alibaba

Spring AI Alibaba ウェブサイト： https://java2ai.com

Spring AI Alibaba ウェブサイトのリポジトリ：https://github.com/springaialibaba/spring-ai-alibaba-website

English | 中文

はじめに

このリポジトリには、Spring AI と Spring AI Alibaba の基礎から高度な使い方まで、また AI プロジェクトのベストプラクティスを紹介するサンプルモジュールプロジェクトが多数含まれています。

詳しくは、各サブプロジェクトの README.md と Spring AI Alibaba 公式サイトをご覧ください。

開発への参加

どのような形式のコード貢献も歓迎します。

クイックスタート一覧（コミュニティによる貢献）

モジュール	目的	コマンド	必要なサービス	環境変数	環境変数テンプレート	エントリー
spring-ai-alibaba-helloworld	基本的なチャットとアドバイザーのサンプル	mvn -pl spring-ai-alibaba-helloworld spring-boot:run	なし	AI_DASHSCOPE_API_KEY	—	README
spring-ai-alibaba-chat-example/dashscope-chat	DashScope チャットの基礎	mvn -pl spring-ai-alibaba-chat-example/dashscope-chat spring-boot:run	なし	AI_DASHSCOPE_API_KEY	—	README
spring-ai-alibaba-image-example/dashscope-image	DashScope 画像生成	mvn -pl spring-ai-alibaba-image-example/dashscope-image spring-boot:run	なし	AI_DASHSCOPE_API_KEY	—	README
spring-ai-alibaba-mcp-example	MCP のデモ	mvn -pl spring-ai-alibaba-mcp-example spring-boot:run	なし／ローカル MCP ツール	モデル API キー	.env.example	README
spring-ai-alibaba-rag-example	RAG のデモ	mvn -pl spring-ai-alibaba-rag-example spring-boot:run	ベクトルデータベース（プロファイルにより任意）	モデル API キー、埋め込みモデル	.env.example	README
spring-ai-alibaba-tool-calling-example	ツール呼び出し	mvn -pl spring-ai-alibaba-tool-calling-example spring-boot:run	なし	モデル API キー、地図 API キー	.env.example	README

よく使う設定キー一覧

設定キー	主なモジュール	説明
AI_DASHSCOPE_API_KEY	spring-ai-alibaba-helloworld、DashScope chat/image、tool calling、evaluation、多くの graph/rag サンプル	DashScope 互換モデルで最もよく使われる API キー
OPENAI_API_KEY	spring-ai-alibaba-chat-example/openai-chat、spring-ai-alibaba-chat-example/vllm-chat	OpenAI 互換インターフェースのサンプルでよく使われます
AI_OPENAI_API_KEY	spring-ai-alibaba-image-example/openai-image	OpenAI の画像生成サンプルで使用します
AI_DEEPSEEK_API_KEY	spring-ai-alibaba-chat-example/deepseek-chat、spring-ai-alibaba-mem0-example	DeepSeek 関連のサンプルで使用します
MINIMAX_API_KEY	spring-ai-alibaba-chat-example/minimax-chat	MiniMax モデルのサンプルで使用します
ZHIPUAI_API_KEY	spring-ai-alibaba-chat-example/zhipuai-chat	Zhipu モデルのサンプルで使用します
BAIDU_MAP_API_KEY	spring-ai-alibaba-tool-calling-example	地図ツール呼び出しのサンプルで必要です

よくある起動時の問題／トラブルシューティング

• AI_DASHSCOPE_API_KEY が設定されていない／AI_DASHSCOPE_API_KEY が見つからない：まず、現在のシェルまたは IDE で環境変数が有効になっていることを確認してから、サンプルを再起動してください。
• ポートが使用中／ポートを使用できない：該当モジュールの application.yml で server.port を確認し、ポートを解放するか変更してから再試行してください。
• ローカルの依存サービスが起動していない／必要なローカルサービスが実行されていない：RAG、MCP、ベクトルデータベース、Docker 関連のサンプルでは、通常、対応するミドルウェアまたはコンテナーを先に起動する必要があります。
• モジュールに .env.example がまだない／モジュールに .env.example がない：まず該当モジュールの README と src/main/resources/application.yml を確認し、実際の変数名と依存サービスを確認してください。