> For the complete documentation index, see [llms.txt](https://docs.digitalhumans.jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digitalhumans.jp/ops/chatbot-integration/connect-dify.md).
# Dify と接続する
{% hint style="info" %}
サービスURL
ドキュメントURL
{% endhint %}
{% hint style="warning" %}
設定時のおねがい：会話AIからの出力を**マークダウン形式にしない、マークダウンを含まない**ようにシステムプロンプトで制御してください。マークダウン形式で発話リクエストが届いた場合、音声合成に失敗します。
{% endhint %}
## Dify.aiならびにオープンソース版Difyとデジタルヒューマンを接続する
まず最初にチャットボット アプリを作成します。RAG+LLMを使ってテキストでのやり取りができる所まで設定を行ってください。
デモやフリートライアルで利用する場合は、御社のセキュリティ対策として以下の方法で利用するアプリを複製してください。
### 1.アプリの複製
対象のアプリの右下…メニューからアプリを`複製`してください。
### 2.API情報を取得する
複製したアプリを開き、APIキーからAPIシークレットキーを作成してください。
作成した`APIキー`をコピーしてメモ帳等に保存しておきます。
`APIサーバーのURL`もコピーしてメモ帳等に保存しておきます。
## NLPプロファイル 個別パラメータ
DIP上でNLPアカウントからプロファイルを選択して下記を設定してください。
### endpoint\_base\_url
リクエストするAPIサーバーURLを設定します。
設定例：`https://api.dify.ai/v1` デフォルト：`https://api.dify.ai/v1`
### conversation\_id
dify.aiへのリクエストデータに`conversation_id` を設定します。
設定を行うと、その場面から会話が開始されます。値はdify.ai画面で確認します。 デフォルト：なし
### from\_quick\_reply\_to\_suggested\_response
ChatbotのクイックリプライをDHのクイックリプライとして表示します。
* `contents` : コンテンツ表示エリアへ表示。 文章をクリックすることで、ユーザー発話としてリクエストされます。
* `dhx` : dhx.jsが提供する[サジェスト機能](https://gitlab.digitalhumans.jp/docs/docs-digitalhumansjp/-/blob/main/settings/README.md)で表示。 表示されるボタンをクリックすることで、ユーザー発話としてリクエストされます。
デフォルト：なし
{% hint style="warning" %}
設定されていない状態で、フォローアップ機能が有効になっている場合、dhx.jsの表示方法で表示されます。
{% endhint %}
### hide\_contents
Chatbotにリクエストする前にinstructions`hideContent`を設定するパラメータ。
`true` で`hideContent`を設定し、Chotbotへのリクエスト送信前に自動的にコンテンツレンダリングエリアが非表示になります。 デフォルト：なし
### stream
streamで処理を行うか設定します。ストリーミングで処理を行う方がデジタルヒューマンがしゃべり出すまでの時間が短縮されますので、通常は`true`で運用してください。
`true`でstream処理を行います。 デフォルト：`true`
## オンプレミス/プライベートクラウド環境でのDifyにおける接続要件
下記の点を考慮して、接続に必要な情報をご提供ください。
* TLS/SSL対応
* エンドポイントとの通信は必ずTLS/SSL (HTTPS) で暗号化されていること
* 有効なSSL証明書が必須
* DNSホスト名要件
* エンドポイントはFQDN（完全修飾ドメイン名）で構成されていること
* IPアドレスでの直接アクセスは非対応
* 適切なDNS設定が必須
* ネットワークアクセス制御
* インターネットを経由してアクセスできることが必須です
* ngrok等のURLでも対応します
* 送信元IPアドレスによるアクセス制限を実装する場合：
* 弊社側IPアドレスは下記です。下記IPアドレスからの接続を許可して下さい。
54.65.129.252 52.198.202.211 57.180.69.236 175.41.239.167
* 一部の接続プロファイルでは、送信元IPアドレスが動的に変更される可能性があるため、固定IPアドレスでの制限が困難な場合があります
* 必要に応じて代替の認証方式の検討してください