AI Command
3.1.1 AI
説明
AI - AIと対話する(8.2以降)。
"AI Chat" は、AIにメッセージを送信し、その応答を_AI_RESPONSEスクリプト変数に保存します。現在のデスクトップ画面の画像やテキストファイルを添付するには、screenと attach パラメータを使用します。
AIの応答は3つの方法でテストできます:
“text" およびオプションの "distance" パラメータを使用して、AI応答が特定の語句を含んでいることを確認します。 応答が一致しない場合、スクリプトは終了します 。
より柔軟なテキストマッチングを行うには、"pattern"正規表現にマッチする応答を検索する。応答が一致しない場合、スクリプトは終了 します。
“text” も "pattern" も指定しなかった場合、応答はスクリプト変数 _AI_RESPONSE に保存され、スクリプトの続行が許可されます。その後、if/else を使用して変数をテストすることができます。 論理式 contains"、"startswith"、"endswith"、または "matches" などのブール式を使用して変数をテストすることができます。もうひとつの方法は 文字列コマンド(Stringコマンド)でテキストを解析することです。.
以下の 例セクションをご覧ください。
利用方法
ai chat [message=<text>] [ai=<Claude|OpenAI>] [screen=<true|false>] [attach=<file(s)>] [text=<pattern>] [distance=<number>] [pattern=<regexp>]
赤色は 必須パラメータです。
オプション
message=<text>
メッセージテキスト("質問")、例えば "Is there a dog on the screen?"。
ai=<Claude|OpenAI>。
オプションのAI名。"Claude" または "OpenAI" のいずれかです。。この名前は通常、複数のAIが設定されていて、特定のAIをターゲットにしたい場合にのみ指定します。名前が指定されていない場合、コマンドは設定されているAIを使用するか、両方が設定されている場合はClaudeを使用します。
screen=<true|false>
true "を指定すると、接続されているデスクトップ画像のコピーをAI質問に添付します(オプション)。デフォルト値は "false"(画面を添付しない)です。
attach=<ファイル>
オプションのファイル、または質問に添付するファイルのコロンまたはセミコロンで区切られたリスト。これは以下のものに限られます:
Javaでサポートされている画像ファイル (PNG、JPG、BMP、GIF、TIFF、WBMP)
プレーンテキストファイル、およびXML、HTMLなどの可読テキストコンテンツを含むファイル。
[text=<パターン>]
AIの回答を照合するためのオプションの大文字文字(「含む」)。例えば、"dog "という値を指定すると、AI応答が "dog "という単語を含む場合は合格となりますが、"DOG" や "Dog" を含む場合は不合格となります。寛容なマッチングには、"distance "または "pattern "パラメータを使用します。text "および"pattern "パラメータは相互に排他的であり、一度に使用できるのは1つだけです。
[distance=<数値>](距離=<数値>)
許容テキスト検索を行うために”text”パラメータと組み合わせてオプションの距離を使います。。パラメータがデフォルト値0(距離なし)に設定されている場合、コマンドはプレーン文字列検索に戻り、提供された文字列の最初の出現箇所を引数テキストで検索します。
許容(ファジー)テキスト検索は、距離値が 1 以上の場合に実行されます。テキストは、指定された文字列と十分に類似した文字列の出現を検索します。許容度(類似度)はレーベンシュタイン距離に基づいています。これは、一方の文字列を他方の文字列に変換するのに必要な最小の編集回数として定義され、許容される編集操作は1文字の挿入、削除、置換です。この距離は、最大で何文字が省略されるか、または正しく認識されないと、サンプルテキストが等価であるとみなされるかをおおよそ規定しています。
例えば、"dog "の1文字を置換すると"fog "になるため、"text=dog distance=1" のパラメータでは、"There is fog" という応答がマッチします。
[pattern=<正規表現>]
java.util.regex.Pattern に準拠した正規表現で応答を検索します(オプション)。. "の正規表現は、デフォルトでは行末を除くすべての文字にマッチします。この動作は、コマンドの環境設定で変更することができます。
text "と"pattern "パラメータは互いに排他的であり、一度に使用できるのは1つだけです。
例
画面上に犬がいることを確認し、いない場合はスクリプトを終了してください。
Ai chat message="Does the screen show a dog? Answer just \"yes\" or \"no\"." screen=true ai=OpenAI pattern=[Yy]es
画面上に犬がいることを確認し、その結果に基づいて行動してください。
Ai chat message="Does the screen show a dog? Answer just \"yes\" or \"no\"." screen=true ai=OpenAI
if ("{_AI_RESPONSE}" matches "[Yy]es") {
// There's a dog on the screen -> do something
...
} else {
// There's no dog -> do something else
...
}