エージェントの環境設定

エージェントビルダーの右側にある設定パネルには、Preferences、Advanced、History の3つのタブがあります。このページでは最初の2つを扱います。メモリとチャット履歴は専用のページに、ツールは別のページに、History は共有と公開にあります。

各セクションは折りたたみ可能な帯で、それぞれ独自のアイコンと、現在の値の一行要約が付いています。変更は入力が止まってから約1秒後に下書きとして保存されます。上部バーの元に戻す／やり直すボタン、または Ctrl+Z と Ctrl+Shift+Z（Mac では ⌘）を使って編集をたどれます。元に戻す履歴は、ビルダーのページを開いている間保持されます。

Preferences タブ#

Details#

このセクションはビルダーを開いたときは折りたたまれています。エージェントがどのように答えるかではなく、エージェントに関する事実を保持します。

• Name. 最大100文字です。名前は Enter を押すか、フィールドから離れたときに保存されます。
• Description. Agents 一覧、ライブラリのカード、チャットのウェルカムに表示されます。
• Category. エージェントを分類するカテゴリです。
• Chat input placeholder. 空のチャットボックスに表示されるグレーのテキストです。
• Disable text input. チャットのテキストボックスをオフにします。
• Detailed description. Markdown で書く、より長いテキストです。

Model & instructions#

• Model. エージェントが思考に使う言語モデルです。デフォルトでは、ワークスペースがデフォルトとして指定したモデルが選択されます。
• Reasoning Effort. 対応しているモデルのみに表示されます。選択できる値はモデルによって異なります。デフォルトは none です。
• Deep agent. スイッチです。エージェントにファイルシステム、計画ツール、そして作業を任せられる1つのヘルパーサブエージェントを与えます。長く多段階のタスクに使います。通常のエージェントはより速く答えます。
• System Message. 指示です。エージェントが何者か、何をしてよいか、どのように答えるべきかを記述します。デフォルトは “You are a helpful assistant.” です。
• Show Progress. 動作中にエージェントの進捗とツール呼び出しをチャットに表示します。デフォルトでオンです。

選択した reasoning effort を受け付けないモデルに切り替えると、ビルダーはそれを none、またはモデルで最初に許可されている値にリセットします。

Apps#

エージェントが呼び出せるツールです。agent tools を参照してください。

Triggers#

Chat は常にオンです。テストチャット、チャットボット、API をカバーします。Add trigger をクリックすると、Slack メッセージ、スケジュール、webhook など別のものからエージェントを開始できます。各トリガーにはステータスバッジがあります。

• Active: トリガーは有効です。
• Publish to activate: 下書きにはトリガーがありますが、公開バージョンにはありません。Webhook とスケジュールは公開時に登録されます。
• Connect: トリガーには未接続のアカウントが必要です。クリックして接続します。connecting accounts を参照してください。

歯車アイコンでトリガーの設定を開きます。3点メニューで削除します。利用可能なトリガーは step reference に一覧されています。

Advanced タブ#

Generation#

• Temperature. 値が高いほど回答はよりランダムに、低いほどより決定論的になります。デフォルトは 0.7、範囲は 0 から 2 ですが、一部のモデルはより低く制限します（Anthropic のモデルは 1 で止まります）。reasoning モデルでは無視されるため、非表示になります。
• Max Output Tokens. 1回の回答の最大長です。デフォルトは 3000 です。
• Max Iterations. エージェントが実行できる思考とツール呼び出しのラウンド数です。デフォルトは 20、最大は 250 です。

Structured output#

オンにすると、エージェントが定義した形で JSON として回答するようになります。Output Schema では、各出力フィールドを名前、型（string、int、float、bool、list、dict）、説明とともに列挙します。

When chat opens#

最初の質問の前にチャットが表示するブロックです。ウェルカムメッセージ、ボタン、カードなどがあります。Add block をクリックし、一覧から1つ選びます。ブロックをドラッグして並べ替え、その行から削除できます。ブロックを開いて内容を編集します。ブロックがない場合、チャットは空で開きます。

Chat history#

memory and chat history を参照してください。

問題が発生した場合#

何も編集できない場合、エージェントを View as a user モードで開いているか、あなたのロールに編集権限がない可能性があります。上部バーの鉛筆アイコンの Edit agent ボタンをクリックしてください。パネルにフローのノードがエージェントフォームと一致しなくなったと表示される場合は、convert to workflow を参照してください。