DifyでAPIMartを使用する

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

準備

1. Difyアカウントの登録済み Dify公式サイトにアクセスしてアカウントを登録し、クラウド版または自己ホスト版を選択
2. APIMart APIキーの取得済み APIMartコンソールにログインしてAPIキー（sk-で始まる）を取得

​

ステップ1：Difyにログインして設定にアクセス

​

1.1 Difyプラットフォームへのアクセス

• クラウド版： https://cloud.dify.aiにアクセスしてログイン
• 自己ホスト版： お使いのDifyデプロイメントアドレスにアクセス

​

1.2 モデル設定ページへの移動

1. 右上のアバターアイコンをクリック
2. 設定を選択
3. 左メニューでモデルプロバイダーを選択

​

ステップ2：APIMartモデルプロバイダーの追加

​

2.1 設定方法の選択

​

方法1：OpenAIカスタムAPIを使用（推奨）

1. モデルプロバイダーページでOpenAIプロバイダーを見つける
2. 設定ボタンをクリック
3. 設定ページで：
   • API Key：APIMart APIキーを入力（sk-xxxxxxxxxxxx）
   • API Base URLまたはBase URL：https://api.apimart.ai/v1を入力
4. 保存をクリック

5. 設定完了後、OpenAIプロバイダーページに戻り、モデルリストを表示
6. モデルリストで、使用したいモデルを見つける（例：gpt-4o、gpt-4o-mini、chatgpt-4o-latestなど）
7. モデル右側のスイッチをクリックして有効化（青色は有効を示す）

​

方法2：カスタムモデルプロバイダーの追加

1. カスタムモデルセクションまでスクロール
2. + モデルを追加ボタンをクリック

​

2.2 APIMartプロバイダーの設定

​

2.3 さらにモデルを追加（オプション）

1. カスタムモデルセクションで、+ モデルを追加ボタンを再度クリック
2. 別のモデルの設定情報を入力
3. 保存をクリック

​

GPT-4/5シリーズ

​

Claudeシリーズ

​

Geminiシリーズ

​

ステップ3：アプリケーションでAPIMartモデルを使用

​

3.1 新しいアプリケーションの作成

1. Difyホームページに戻る
2. アプリを作成ボタンをクリック
3. アプリケーションタイプを選択：
   • チャットボット - 会話型アプリケーション
   • テキストジェネレーター - テキスト生成アプリケーション
   • エージェント - インテリジェントエージェント
   • ワークフロー - 複雑なワークフローアプリケーション

​

3.2 APIMartモデルの選択

1. モデル設定エリアを見つける
2. モデルを選択ドロップダウンをクリック
3. APIMartプロバイダーを選択
4. 設定したモデルを選択（例：gpt-4o）

​

3.3 モデルパラメーターの設定

​

ステップ4：アプリケーションの構築とテスト

​

4.1 プロンプトの追加

1. システムプロンプトエリアにプロンプトを記述
2. 変数を使用してアプリを動的にする：
   • {{variable_name}} - ユーザー入力変数
   • {{context}} - ナレッジベースコンテキスト

あなたはプロフェッショナルなカスタマーサービスアシスタントで、製品に関する質問に答えることが得意です。

製品情報：{{product_info}}

ユーザーの質問に基づいて、正確で親しみやすい回答を提供してください。不明な場合は、正直にユーザーに伝えてください。

ユーザーの質問：{{user_question}}

​

4.2 ナレッジベースの追加（オプション）

1. 左メニューでナレッジベースをクリック
2. 新しいナレッジベースを作成してドキュメントをアップロード
3. アプリケーションオーケストレーションページでナレッジベースをリンク
4. 検索パラメーターを設定

​

4.3 アプリケーションのテスト

1. 右側のプレビューパネルにテスト質問を入力
2. AI応答の効果を確認
3. 必要に応じてプロンプトとパラメーターを調整
4. 満足するまでテストを繰り返す

​

4.4 アプリケーションの公開

1. 右上の公開ボタンをクリック
2. 公開方法を選択：
   • API呼び出し - APIによる統合
   • ウェブサイトに埋め込み - 埋め込みコードを生成
   • 公開リンク - 共有リンクを生成

​

ステップ5：監視と最適化

​

5.1 アプリケーションログの表示

1. ログタブをクリック
2. すべての会話記録を表示
3. ユーザーの質問とAI応答を分析
4. 改善の機会を発見

​

5.2 API使用状況の監視

• 📊 API呼び出し統計 - 総呼び出し数、成功率
• 💰 コスト詳細 - 日次/月次コスト
• 📈 使用傾向 - 使用量の変化傾向
• 🔍 リクエストログ - 詳細なリクエスト記録

​

5.3 アプリケーションパフォーマンスの最適化

1. モデル選択の調整
   • 簡単なタスクにはgpt-4o-miniを使用してコストを削減
   • 複雑なタスクにはgpt-4oまたはclaude-sonnet-4-5を使用して品質を向上
2. プロンプトの最適化
   • プロンプトをより明確で具体的にする
   • 例を追加して効果を向上
   • 思考の連鎖を使用して推論能力を向上
3. キャッシュの設定
   • 類似の質問に対してキャッシュを有効化
   • API呼び出しコストを削減

​

高度な機能

​

ワークフローオーケストレーションの使用

1. 条件分岐 - 条件に応じて異なるロジックを実行
2. 複数モデルの連携 - 複数モデルの強みを組み合わせる
3. 外部ツール呼び出し - API、データベースなどの外部リソースを呼び出す
4. 変数の受け渡し - 異なるノード間でデータを受け渡す

​

Agent機能の設定

1. ツール呼び出し - AIに外部ツールを呼び出させる
2. メモリ管理 - 長期的な会話記憶を維持
3. 自律的な意思決定 - AIが実行ステップを自律的に計画

​

マルチモーダルアプリケーション

1. 画像理解 - gpt-4oまたはclaude-3を使用して画像を処理
2. 画像生成 - APIMartの画像生成APIを統合
3. 音声処理 - TTSおよびSTTサービスを統合

​

よくある質問

​

Q1: APIMartサービスに接続できない？

1. Base URLの確認：
   • https://api.apimart.ai/v1（/v1を含む）であることを確認
   • 追加のパスを追加したり、/v1を省略したりしない
2. API Keyの検証：
   • API Keyがsk-で始まることを確認
   • APIMartコンソールでキーが有効か確認
3. ネットワーク接続の確認：
   • サーバーがhttps://api.apimart.aiにアクセスできることを確認
   • 自己ホスト版では、サーバーのネットワーク接続を確認

​

Q2: モデルの応答が遅い？

1. より高速なモデルへの切り替え：
   • gpt-4oの代わりにgpt-4o-miniを使用
   • より高速な応答のためにgemini-2.0-flash-expを使用
2. プロンプト長の最適化：
   • 不要なコンテキストを削減
   • プロンプトの説明を簡略化
3. ナレッジベース検索の調整：
   • 検索ドキュメント数を削減
   • 類似度閾値を上げる

​

Q3: API呼び出しが失敗またはエラーを返す？

​

Q4: API使用コストを下げるには？

1. モデル選択：
   • 簡単なタスクにはgpt-4o-miniを使用（コストはgpt-4oの約1/10）
   • バッチ処理では、より経済的なモデルの使用を検討
2. キャッシュの有効化：
   • 同じ質問にはキャッシュ結果を返す
   • Difyで類似度マッチングを設定
3. 出力長の最適化：
   • 適切なMax Tokensを設定
   • 長すぎる応答の生成を避ける
4. ストリーミング出力の使用：
   • コストを増やさずにユーザー体験を向上

​

Q5: 機密データをどう扱えばよいですか？

1. 環境変数の使用：
   • コード内にAPI Keyをハードコードしない
   • Difyの環境変数機能を使用
2. アクセス制御の設定：
   • アプリケーションのアクセス権限を設定
   • API呼び出し時に認証を有効化
3. 監査ログ：
   • アプリケーションログを定期的に確認
   • 異常なアクセスパターンを監視

​

ベストプラクティス

​

1. プロンプトエンジニアリング

# 役割定義
あなたはプロフェッショナルな [役割説明] です

# タスク目標
ユーザーの [タスク説明] を支援する必要があります

# 出力要件
- 要件1
- 要件2
- 要件3

# 入力情報
{{user_input}}

​

2. ナレッジベース管理

• 分割戦略：ドキュメントのチャンクサイズを適切に設定（推奨500-1000文字）
• メタデータ付与：検索しやすいようにドキュメントへメタデータを追加
• 定期更新：ナレッジベースの内容を最新に保つ

​

3. エラー処理

• 分かりやすいメッセージ：ユーザーに明確なエラーメッセージを表示
• フォールバック戦略：メインモデルが失敗した場合は予備モデルへ切り替え
• リトライ機構：一時的なエラーを自動的に再試行

​

4. パフォーマンス監視

• アラート設定：残高不足やエラー率の上昇時にアラート
• 定期分析：週次/月次で使用データを分析
• 継続的な最適化：データに基づいて設定を調整

​

使用シーン例

​

1. インテリジェントカスタマーサポート

• モデル：gpt-4o-mini（高いコスト効率）
• ナレッジベース：製品ドキュメント、FAQ
• 機能：よくある質問への自動回答、複雑な質問は担当者へ引き継ぎ

​

2. コンテンツ作成アシスタント

• モデル：gpt-4oまたはclaude-sonnet-4-5（高品質）
• 機能：記事生成、書き換え、校正
• パラメーター：Temperature=0.8（創造性を高める）

​

3. コードアシスタント

• モデル：claude-sonnet-4-5（コードに強い）
• 機能：コード生成、説明、デバッグ
• ナレッジベース：プロジェクトドキュメント、APIドキュメント

​

4. データ分析アシスタント

• モデル：gpt-4o（強力な推論能力）
• ツール：Pythonコード実行、データ可視化
• 機能：データ分析、レポート生成

​

機能特性

• 🤖 AIアプリを素早く構築 - コーディングなしで強力なAIアプリを作成
• 📚 ナレッジベース強化 - RAG技術によりAIが自社データに基づいて回答
• 🔧 柔軟なワークフロー - 複雑なAIロジックを視覚的に編成
• 🎯 精密なプロンプト管理 - バージョン管理とA/Bテスト
• 📊 包括的な監視分析 - アプリケーションの利用状況と性能を把握
• 🔌 複数の統合方式 - API、埋め込み、WebAppなどの方式
• 👥 チームコラボレーション - 複数人でのアプリ開発をサポート
• 🌐 マルチモデル対応 - 異なるAIモデルを柔軟に切り替え

​

サポート＆ヘルプ

• 📚 APIMartドキュメント
• 📚 Dify公式ドキュメント
• 💬 Discordコミュニティ
• 🐦 Twitter @APIMart_
• 📧 技術サポート：zhihong@apimart.ai