<h2 id="%E5%89%8D%E7%BD%AE%E3%81%8D">
<a class="header-anchor-link" href="#%E5%89%8D%E7%BD%AE%E3%81%8D" aria-hidden="true"></a> 前置き</h2>
<p>みなさんこんにちは。Difyがアップデートされ、バージョン<a href="https://github.com/langgenius/dify/releases/tag/0.6.9" target="_blank" rel="nofollow noopener noreferrer">0.6.9</a>にてiterationが追加されました。<br>
iterationを使うと、入力された配列データを順番に処理し、結果を積み重ねていくことができます。<br>
今回はiterationの使い方をワークフロー例とともに紹介したいと思います。</p>
<h3 id="%E5%AE%9F%E8%A1%8C%E7%92%B0%E5%A2%83">
<a class="header-anchor-link" href="#%E5%AE%9F%E8%A1%8C%E7%92%B0%E5%A2%83" aria-hidden="true"></a> 実行環境</h3>
<p>Dify:0.6.9</p>
<h3 id="%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC%E3%81%AE%E6%A6%82%E8%A6%81">
<a class="header-anchor-link" href="#%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC%E3%81%AE%E6%A6%82%E8%A6%81" aria-hidden="true"></a> ワークフローの概要</h3>
<p>今回作成したワークフローは以下のような構成になっています。</p>
<ul>
<li>ポケモンの名前を入力する</li>
<li>入力されたポケモンの進化系統を英訳して取得する</li>
<li>取得した進化系統のポケモン名を配列にする</li>
<li>iterationブロックで配列の各要素(ポケモン名)を処理</li>
<li>ポケモンの英名で<a href="https://pokeapi.co/" target="_blank" rel="nofollow noopener noreferrer">pokeAPI</a>を叩いてポケモンの情報を取得</li>
<li>取得したデータを整形</li>
<li>最終的な出力をまとめて返す</li>
</ul>
<h2 id="%E5%85%A8%E4%BD%93%E5%9B%B3">
<a class="header-anchor-link" href="#%E5%85%A8%E4%BD%93%E5%9B%B3" aria-hidden="true"></a> 全体図</h2>
<p><img src="https://storage.googleapis.com/zenn-user-upload/09621436c6cd-20240531.png" loading="lazy" class="md-img"></p>
<h2 id="%E5%90%84%E3%83%96%E3%83%AD%E3%83%83%E3%82%AF">
<a class="header-anchor-link" href="#%E5%90%84%E3%83%96%E3%83%AD%E3%83%83%E3%82%AF" aria-hidden="true"></a> 各ブロック</h2>
<h3 id="%E9%96%8B%E5%A7%8B">
<a class="header-anchor-link" href="#%E9%96%8B%E5%A7%8B" aria-hidden="true"></a> 開始</h3>
<p>入力フィールド:pokemon<br>
<img src="https://storage.googleapis.com/zenn-user-upload/491edd37b0dd-20240531.png" loading="lazy" class="md-img"></p>
<h4 id="llm">
<a class="header-anchor-link" href="#llm" aria-hidden="true"></a> LLM</h4>
<p>モデル:claude-3-haiku-20240307<br>
システムプロンプト:</p>
<div class="code-block-container">
<div class="code-block-filename-container"><span class="code-block-filename">txt</span></div>
<pre><code>あなたは任天堂のポケモンについて回答するBOTです。
入力されたポケモンの進化系統全てを英語名で出力してください。
返答内容はポケモンの名前を英語名でカンマ区切りして返答してください。
カンマ区切りのみでスペースなどは不要です。
</code></pre>
</div><p>ユーザープロンプト</p>
<div class="code-block-container">
<div class="code-block-filename-container"><span class="code-block-filename">txt</span></div>
<pre><code>/開始:pokemon
</code></pre>
</div><p><img src="https://storage.googleapis.com/zenn-user-upload/132bf5ba85c9-20240531.png" loading="lazy" class="md-img"></p>
<h3 id="%E3%82%B3%E3%83%BC%E3%83%89">
<a class="header-anchor-link" href="#%E3%82%B3%E3%83%BC%E3%83%89" aria-hidden="true"></a> コード</h3>
<p>iterationのために文字列を配列に変換</p>
<div class="code-block-container">
<div class="code-block-filename-container"><span class="code-block-filename">python</span></div>
<pre><code>def main(pokemons: string) -&gt; dict:
    return {
        "pokemons": pokemons.lower().split(',')
    }
</code></pre>
</div><p><img src="https://storage.googleapis.com/zenn-user-upload/6e74b14dfc11-20240531.png" loading="lazy" class="md-img"></p>
<h3 id="iteration">
<a class="header-anchor-link" href="#iteration" aria-hidden="true"></a> iteration</h3>
<p>コードで配列化した変数を受け取り、iteration内で要素ごとにitemとindexを取得して利用する<br>
INPUT:/コード:pokemons<br>
OUTPUT VARIABLES:iteration内の末端処理の出力結果(ここを設定しないとiterationの次の処理で結果を取得できない)<br>
<img src="https://storage.googleapis.com/zenn-user-upload/af1a653b13ee-20240531.png" loading="lazy" class="md-img"></p>
<h3 id="http%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88">
<a class="header-anchor-link" href="#http%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88" aria-hidden="true"></a> HTTPリクエスト</h3>
<p><code>{/iteration:item}</code>が何故か無効な変数と表示されるが問題なく動作する<br>
API:<a href="https://pokeapi.co/" target="_blank" rel="nofollow noopener noreferrer">pokeAPI</a>にてポケモンの情報を取得する</p>
<div class="code-block-container"><pre><code>GET:https://pokeapi.co/api/v2/pokemon-species/{/iteration:item}
</code></pre></div><p><img src="https://storage.googleapis.com/zenn-user-upload/2cc746197675-20240531.png" loading="lazy" class="md-img"></p>
<h3 id="llm2">
<a class="header-anchor-link" href="#llm2" aria-hidden="true"></a> LLM2</h3>
<p>モデル:claude-3-haiku-20240307<br>
システムプロンプト:</p>
<div class="code-block-container">
<div class="code-block-filename-container"><span class="code-block-filename">txt</span></div>
<pre><code>あなたは任天堂から発売されているポケットモンスター（ポケモン）の図鑑BOTです。
こちらから提供される情報をもとに日本語の情報だけまとめて以下の構文で回答してください。
language/11の図鑑情報を使用してください
名前 :
タイプ : 
図鑑情報 : 
</code></pre>
</div><p>ユーザープロンプト</p>
<div class="code-block-container">
<div class="code-block-filename-container"><span class="code-block-filename">txt</span></div>
<pre><code>/HTTPリクエスト:body
</code></pre>
</div><p><img src="https://storage.googleapis.com/zenn-user-upload/b792f5d6e3ed-20240531.png" loading="lazy" class="md-img"></p>
<h3 id="%E7%B5%82%E4%BA%86">
<a class="header-anchor-link" href="#%E7%B5%82%E4%BA%86" aria-hidden="true"></a> 終了</h3>
<p>出力変数:iterationの出力結果<br>
<img src="https://storage.googleapis.com/zenn-user-upload/a930dc0eea02-20240531.png" loading="lazy" class="md-img"></p>
<h2 id="%E5%AE%9F%E8%A1%8C">
<a class="header-anchor-link" href="#%E5%AE%9F%E8%A1%8C" aria-hidden="true"></a> 実行</h2>
<p>今回はヒトカゲでやってみます。</p>
<p>入力：ヒトカゲ<br>
<img src="https://storage.googleapis.com/zenn-user-upload/4884aa1f1cb5-20240531.png" loading="lazy" class="md-img"></p>
<p>出力：ヒトカゲ</p>
<div class="code-block-container"><pre><code>{
  "pokemon_evolutions": [
    "名前 : ヒトカゲ\nタイプ : ほのお\n図鑑情報 : \n生まれたときから尻尾に炎が点っている。炎が消えたときその命は終わってしまう。しっぽの炎は気分を表現し、楽しい時は炎がゆらゆら揺れ、怒った時は炎がめらめら盛んに燃える。あついものを好む性格で、雨に濡れると尻尾の先から煙が出るという。",
    "名前 : リザード\nタイプ : ほのお\n図鑑情報 : 強敵と戦いつづけるとエキサイトし、青白い炎を吐くことがある。鋭い爪で相手を徹底的に攻撃する性格の持ち主。",
    "名前 : リザードン\nタイプ : ほのお / ひこう\n図鑑情報 : 強い相手を求めて空を飛び回る。なんでも溶かして しまう高熱の炎を自分より弱いものに向けることは しない。岩石も焼けるような灼熱の炎を吐いて山火事を 起こすことがある。地上1400メートルまで羽を使って飛ぶ ことができる。高熱の炎を吐く。"
  ]
}
</code></pre></div><p><img src="https://storage.googleapis.com/zenn-user-upload/d7f376503290-20240531.png" loading="lazy" class="md-img"></p>
<h2 id="%E3%81%BE%E3%81%A8%E3%82%81">
<a class="header-anchor-link" href="#%E3%81%BE%E3%81%A8%E3%82%81" aria-hidden="true"></a> まとめ</h2>
<p>iterationを使えば配列のデータを処理できますが、今回のような文字列でもコードで配列化すれば問題なく対応できした。配列化は今後も使うことにはなりそうな気がします。<br>
ワークフローの最後の出力などをjsonで出すこともできますが、一旦はiterationがみたいだけなので割愛しました。<br>
また、プロンプトももう少し頑張るべきかもですが"いずれ、おそらく、多分、きっと"修正します。</p>


Difyにiterationが追加されたので使用感を確かめる

Discussion