エージェントツール

コーディングエージェントは、それぞれ独自のツールを持っています。ファイルの読み取り、コマンドの実行、コードの編集などです。OAR はその上に小さなツール群を追加し、リレーにしかできないことをエージェントができるようにします。ほかのセッションとの連携、Web プレビューの公開、ワンタップで答えられる質問です。

これらのツールを自分で呼び出すことはありません。普通の言葉で頼めば、エージェントがツールを選びます。このセクションでは、エージェントに何ができるのか、何にあなたの承認が必要なのか、正確に何を送って何を受け取るのかを説明します。

ツール #

• relay_toolrelay_tool エージェントツールで、このリレーとペアリングしたリレーのセッションを扱います。23 のアクションすべてについて、パラメーターと結果、権限、制限、エラーを説明します。
• previewエージェントツール preview は、ローカルの開発サーバーやフォルダーを公開リンクで公開します。アクション、パラメーター、結果、設定、制限を説明します。
• ask_userエージェントがボタン付きのカードであなたに質問する仕組みとして、OAR の ask_user ツールとプロバイダー独自の質問ツールを、プロバイダーごとのパラメーターとあわせて説明します。

頼めること #

依頼の例と、エージェントが使うツール：

プロバイダー別 #

ツールの動作は、どのプロバイダーでも同じです。違うのは、プロバイダーのエージェントがそのツールを使えるかどうかと、エージェントから見えるツールの名前です。

Claude API と DeepSeek のチャットはリレーのホストで Claude Code を動かすので、そのエージェントは Claude のチャットとまったく同じようにツールを受け取ります。Claude API と DeepSeek を参照してください。

Claude Cloud のセッションは、自分のマシンではなく Anthropic のサンドボックスで動きます。リレーのツールはその中には届きません。クラウドセッションには relay_tool も preview もありません。それでも、ほかのセッションのエージェントは、relay_tool でクラウドセッションの開始、読み取り、プロンプトの送信、停止ができます。

Grok と Copilot の拡張機能エンジンは、OAR がエージェントに接続する小さな MCP サーバーからツールを受け取ります。リレーに環境変数 OAR_MCP_SERVER=0 を設定すると、そのサーバーはオフになります。その場合、これらのエージェントには relay_tool がなく、preview ツールの代わりにプレビュー API の呼び出し方が伝えられます。

ツールが使えるとき #

セッションが relay_tool を得られるかどうかは、そのエージェントのプロセスが起動したときに決まります。最初のリレーをペアリングしたり、エージェントのセッションをオンにしたりした後も、すでに実行中だった会話では、エージェントが再起動するまでツールがないことがあります。0.9.18 で追加 ツールの新しい名前についても同じです。0.9.18 に更新したときに実行中だったセッションでは、ツールがまだ remote_relay という名前のことがあります。名前を参照してください。

自分で管理できること #

• 会話の外に届くものは、既定では何もオンになっていません。 エージェントのセッションはオンにするまでオフです。ペアリングしたリレーは、会話ごとに言及するまでロックされています。プレビューレーンは設定するまでオフです。
• 承認カード。 会話でエージェントが最初に開始するセッション、リレーで初めてセッションを監視するとき、そして ask と plan のリレーモードでのすべての書き込みアクションでは、質問カードで先にあなたに確認します。
• ツールがエージェントにトークンを渡すことはありません。 別のリレーへの呼び出しは、そのリレーのトークンを保持している自分のリレーを経由します。これはサンドボックスではありません。エージェントはリレーのユーザーとして動くので、設定ファイルやデータベースをディスクから読むことができます。OAR が公開するものを参照してください。
• プレビューのリンクは公開されます。 プレビューのリンクを持っている人は誰でも、サインインせずに開けます。エージェントには、リンクを渡すときにそのことを伝えるよう指示されています。エージェントが一覧表示して閉じられるのは自分の会話のプレビューだけです 0.9.14 で追加。Settings → Previews（設定 → プレビュー）では、すべてのプレビューを表示して閉じられます。

詳しくは各ツールのページにあります。relay_tool → 権限と承認と preview → 制限を参照してください。

ツールではないもの #

OAR でエージェントが行うことの中には、OAR のツールなしで動くものもあります。

• 返信内の画像、動画、音声。 エージェントには、メディアファイルを絶対パスで埋め込めると伝えられ、リレーがそれをインラインで表示します。これはプロンプト内の指示であり、ツールではありません。Copilot の拡張機能エンジンと Claude Cloud のエージェントには、この指示は届きません。
• 入力欄の /preview。 /preview と入力すれば、自分でプレビューの公開、一覧表示、終了ができます（入力欄）。エージェントのターンを消費せず、どのプロバイダーでも使えます。
• プランボード。 エージェントがプランを書き終えると、OAR は Plan ready（プランの準備完了）のボードを表示します。Claude と DeepSeek では、これは Claude Code 自身のプランツールから来たもので、OAR がそれを拾います。