suggest_tags¶
部分的なプロンプトを補完または洗練する NovelAI プロンプトタグを提案します。 提案は NovelAI の学習セットタガーによって順位付けされ、学習データでの出現回数と ともに返されます。
パラメーター¶
名前 |
型 |
デフォルト |
備考 |
|---|---|---|---|
|
|
必須 |
補完する部分的なプロンプトテキスト。 |
|
|
|
タガーの語彙 ( |
|
|
|
ISO 639-1 のレスポンス言語 (例: |
戻り値¶
list[TagSuggestion] — 各提案は NovelAI が返すフィールドを持ちます:
キー |
型 |
備考 |
|---|---|---|
|
|
タグ文字列そのもの (プロンプトでこれを使います)。 |
|
|
学習セットでの出現回数 (大きいほど一般的)。 |
|
|
この補完に対するタガーの信頼度 (0–1)。 |
ワイヤー上の形は実際に検証済みです ( API サーフェスの整合 を参照):
例¶
result = await ctx.session.call_tool("suggest_tags", {
"prompt": "1girl, fox ears,",
"model": "nai-diffusion-4-5-full",
"language": "en",
})
# result: [
# {"tag": "fox girl", "count": 10000, "confidence": 0.745},
# {"tag": "fox tail", "count": 4321, "confidence": 0.612},
# ...
# ]
ヒント¶
Tip
反復的なプロンプト構築: プロンプトを編集するたびにエージェントへ suggest_tags を
呼ばせ、シーンに合う最上位の提案を採用します。思い付かなかったタグを素早く
見つける方法です。
タグの count と品質
count はそのタグが NovelAI の学習データにどれだけ頻繁に現れるかを示すもので、
あなたのプロンプトにとってどれだけ 有用 かではありません。珍しいタグ (count が小さい)
でも、シーンの完璧な記述子になり得ます。