本文へスキップ
AI@https://hoody.com Connect to Hoody
hoody / capabilities

Hoodyでできることすべて

Hoodyでできること。
5つの考え方と、 500 項目。

Hoodyは、少数の考え方を何度も使い回したものです。まず5つの考え方を確認し、続けて構成要素を平易な言葉で順に見ていきます。全部で 500 項目を 52 グループに分けています。各項目に、AIに伝える内容を載せています。ほとんどの項目には、使う前に知っておくことと、ドキュメントへのリンクも載せています。AIはこれらを組み合わせて、さらに多くのことを実現します。

項目のIDを指定すると、その項目へリンクできます。例:/capabilities/#c120。ページ内の検索には、ブラウザーの検索機能を使います。

hoody / capabilities / ideas

一覧の前に

すべての項目の土台にある5つの考え方。

一覧は長いですが、考え方は少数です。下の各項目は、この5つのどれかが形になったものです。

AI

考えることと話すこと。

Hoody AIは無料で、最初から組み込まれています。ChatGPTまたはClaudeのプラン、あるいはほかのAIも使えます。

Hoody

手元に残る基盤。

インフラのホスティングと運用はHoodyが行います。AIはそのすべてを使えます。

Kit

すべてのサービスが含まれます。どれもURLで使えます。

ターミナル・デスクトップ・ファイル・ブラウザー・データベースなどが、どのコンピューターにも入っています。Kitを見る

  1. 常時稼働のコンピューター

    Hoodyのコンピューターは、クラウド上の完全なLinuxマシンです。タブを閉じても動き続けます。

    リクエスト1件で作成できますPOST https://api.hoody.com/api/v1/projects/{p}/computers
    使うとどうなるか

    離れている間も、サイト、ジョブ、ファイルは動き続けます。AIにコンピューターを頼むと、すぐ使える状態になります。

    c01 常時稼働のコンピューターa02 オンデマンドのコンピューターx04 スナップショットと取り消しdocs / concepts / computers

  2. すべてにURLがある

    コンピューター内のツールには、それぞれ専用のHTTPSリンクがあります。リンクの単語を1つ変えると、別のツールに移れます。

    同じコンピューターで、2つのツールhttps://{p}-{c}-terminal-1.{node}.computers.hoody.comhttps://{p}-{c}-display-1.{node}.computers.hoody.com
    使うとどうなるか

    インストールは不要です。人もスクリプトもAIも、同じリンクを開けます。

    x01 すべてがURLc24 サイトとアプリの公開x02 リアルタイムの共同作業docs / concepts / everything-is-a-url

  3. 1つのAPI、シンプルなHTTP

    Hoodyでできることは、AIやスクリプトからも実行できます。APIはHTTP上のシンプルなRESTです。

    プロジェクトを一覧表示curl "https://api.hoody.com/api/v1/projects/" \ -H "Authorization: Bearer $HOODY_TOKEN"SDKを使う場合npm install hoody-sdk
    使うとどうなるか

    SDKは任意です。Webリクエストを送れるものなら、curl、スクリプト、AIのどれでもHoodyを操作できます。

    a01 すべてを1つのAPIでx09 @hoody.comと伝えるx10 ssh hoody.comdocs / foundation / hoody-apigithub / hoody-sdk

  4. 作業を担うBotとエージェント

    Botは、使い続けられる1つのチャットです。頼んだ作業をコンピューター上のエージェントに渡し、その実行内容を報告します。

    専用アドレスを持つBothttps://<label>.hoody.bot
    使うとどうなるか

    してほしいことを、ふだんの言葉で伝えます。同じBotが、Telegram、Slack、Discordで答えます。

    b01 Botb10 すべてのチャットアプリで1つのBotb11 すべてのコンピューターにHoody AgentBotのページ

  5. 非公開のリンクと、実際に効くロック

    生成されるリンクは推測できないため、共有するまで他の人には知られません。どのリンクも、パスワード、ログイン、IPリストでロックできます。

    グループ外の全員を拒否"default": "deny"
    使うとどうなるか

    どのツールを誰が開けるかは、自分で決めます。ルールを設定するまでは、リンクを知っている人なら誰でも開けます。

    x05 非公開リンクx06 どのリンクもロックx23 暗号化されたディスクdocs / concepts / security

続いて一覧、 500 項目

hoody / capabilities / computers

01 264 項目

コンピューター

ブラウザーで使える常時稼働のコンピューターです。ツールごとにリンクがあります。

常時稼働、デスクトップ付き 10

  • c01

    常時稼働のコンピューター

    タブを閉じても、コンピューターは起動したまま動き続けます。

    AIに伝える内容
    これをHoodyのコンピューターで動かし続けてください。

    docs / foundation / computers / managing

  • c02

    タブの中のデスクトップ

    ブラウザーでフルデスクトップを開きます。

    リンクhttps://{p}-{c}-display-1.{node}.computers.hoody.com

    AIに伝える内容
    コンピューターでデスクトップを開いてください。

    補足プロキシの権限を設定するまでは、リンクを知っている人なら誰でもデスクトップを使えます。

    docs / kit / displays

  • c03

    どんなLinuxアプリでも

    どんなLinuxアプリでも実行し、スマートフォンを含むどのブラウザーからでも使えます。

    リンクhttps://{p}-{c}-display-1.{node}.computers.hoody.com

    AIに伝える内容
    LibreOfficeを実行して、リンクを送ってください。

    docs / kit / displays

  • c04

    AIが画面を操作

    デスクトップで、AIがクリック、入力、ウィンドウの読み取り、スクリーンショットの撮影を行えます。

    リンクhttps://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/screenshot

    AIに伝える内容
    デスクトップのスクリーンショットを撮って、「保存」をクリックしてください。

    docs / kit / displays

  • c05

    コピーと貼り付けを連携

    デバイスとデスクトップの間で、コピーと貼り付けができます。

    リンクhttps://{p}-{c}-display-1.{node}.computers.hoody.com

    AIに伝える内容
    このテキストをデスクトップのアプリに貼り付けてください。

    補足貼り付けを使うには、ブラウザーがクリップボードの権限を求めることがあります。

    docs / kit / displays

  • c55

    コンピューターの一時停止

    コンピューターを一時停止し、数秒で再開します。セッションとメモリはそのまま残ります。

    リンクhttps://api.hoody.com/api/v1/computers/{id}/pause

    AIに伝える内容
    開発用コンピューターを明日まで一時停止してください。

    補足一時停止中のコンピューターは、RAMとディスクを使用したままです。再開するまで、サービスのURLはエラーを返します。サーバーを再起動すると、一時停止の状態は失われます。

    docs / foundation / computers / managing

  • c56

    複数の独立したディスプレイ

    それぞれ独自の解像度、ウィンドウ・アプリを持つ別々のデスクトップを動かします。

    AIに伝える内容
    ブラウザーとエディターを別々のディスプレイに分けてください。

    補足セッションは、開始する前にディスプレイ番号ごとに設定を済ませておく必要があります。

    docs / kit / displays

  • c57

    デスクトップ環境の選択

    XfceまたはMATEのデスクトップ環境でディスプレイを起動します。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/create

    AIに伝える内容
    MATEデスクトップでディスプレイを起動してください。

    補足既存のターミナルセッションは、設定をそのまま保持します。

    docs / kit / displays

  • c58

    Kitなしのコンピューター

    Kitのサービスなしでコンピューターを作成し、独自のHTTPサーバーを動かします。

    リンクhttps://api.hoody.com/api/v1/projects/{p}/computers

    AIに伝える内容
    自分のWebサーバー用に、Kitなしのコンピューターを作ってください。

    補足通常のコンピューターには、ブラウザー用のシェルが組み込まれていません。最初のSSH接続には、SSH公開鍵を設定してください。

    docs / foundation / computers / create-edit-delete

  • c59

    ディスプレイの停止

    ディスプレイを停止し、その上で動くプログラムも終了します。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/system/displays/{displayId}/stop

    AIに伝える内容
    ディスプレイ1とそのプログラムを停止してください。

    補足ディスプレイを停止すると、そこで動いているプログラムはすべて終了します。未保存の作業も含まれます。

    docs / kit / displays

デスクトップビューアーのオプション 9

  • c60

    デスクトップのファイル転送

    ブラウザーとディスプレイの間でファイルを転送します。

    リンクhttps://{p}-{c}-display-1.{node}.computers.hoody.com/

    AIに伝える内容
    このファイルをディスプレイに転送してください。

    docs / api / displays / feature-flags

  • c61

    デスクトップの音声を聞く

    ディスプレイの音声を、表示中のブラウザーで再生します。

    リンクhttps://{p}-{c}-display-1.{node}.computers.hoody.com/?sound=true

    AIに伝える内容
    デスクトップの音声をこのブラウザーで再生してください。

    docs / api / displays / web-client

  • c62

    プレゼンテーションの視聴

    共有デスクトップを、クリックも入力もできない閲覧者として開きます。

    リンクhttps://{p}-{c}-display-1.{node}.computers.hoody.com/?sharing=true&steal=false&readonly=true

    AIに伝える内容
    デスクトップのプレゼンテーション用に、閲覧用リンクをください。

    補足読み取り専用の表示モードは、アクセス制御ではありません。HTTP APIは引き続き入力を受け付け、プロキシの権限には閲覧専用のレベルがありません。

    docs / kit / displays

  • c63

    デスクトップから印刷

    ディスプレイの印刷ジョブをブラウザーに転送します。

    リンクhttps://{p}-{c}-display-1.{node}.computers.hoody.com/

    AIに伝える内容
    デスクトップからこのドキュメントを印刷してください。

    docs / api / displays / feature-flags

  • c64

    キーボード配列の選択

    デスクトップビューアーのキーボード配列を選びます。

    リンクhttps://{p}-{c}-display-1.{node}.computers.hoody.com/?keyboard_layout=gb

    AIに伝える内容
    デスクトップでイギリス英語のキーボード配列を使ってください。

    docs / kit / displays

  • c65

    タッチスクリーン用キーボード

    タッチスクリーンでデスクトップを使うときに、仮想キーボードを表示します。

    リンクhttps://{p}-{c}-display-1.{node}.computers.hoody.com/?keyboard=true

    AIに伝える内容
    タッチスクリーン対応のノートパソコンで仮想キーボードを表示してください。

    docs / kit / displays / reference

  • c66

    ディスプレイの帯域幅を制限

    低速な回線向けに、デスクトップビューアーの帯域幅の上限を設定します。

    リンクhttps://{p}-{c}-display-1.{node}.computers.hoody.com/?quality_mode=reduced&bandwidth_limit=500000

    AIに伝える内容
    デスクトップビューアーを500Kbpsに制限してください。

    docs / kit / displays / reference

  • c67

    開くときにアプリを前面に出す

    名前を指定したウィンドウを最大化し、フォーカスした状態でビューアーを開きます。

    リンクhttps://{p}-{c}-display-1.{node}.computers.hoody.com/?app=Firefox

    AIに伝える内容
    Firefoxを前面にしてデスクトップを開いてください。

    補足ディスプレイを見ているすべての人の画面で、ほかのウィンドウが最小化されます。

    docs / api / displays / web-client

  • c68

    ビューアーのカスタマイズ

    ダークテーマのデスクトップビューアーと、フローティングメニューを使います。

    リンクhttps://{p}-{c}-display-1.{node}.computers.hoody.com/?dark_mode=true&floating_menu=true

    AIに伝える内容
    ダークテーマのビューアーとフローティングメニューでデスクトップを開いてください。

    docs / kit / displays

デスクトップの自動化 7

  • c69

    ウィンドウの移動とサイズ変更

    APIでデスクトップのウィンドウを移動、サイズ変更、最小化、復元、または閉じます。

    リンクhttps://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/window/resize

    AIに伝える内容
    ブラウザーのウィンドウをデスクトップ全体に広げてください。

    補足ウィンドウ操作には、ウィンドウマネージャーのあるデスクトップが必要なものがあります。

    docs / kit / displays

  • c70

    ウィンドウを待つ

    自動化を続ける前に、アプリのウィンドウが表示されるまで待ちます。

    リンクhttps://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/input/wait-until

    AIに伝える内容
    Firefoxが開くまで待ってから続けてください。

    補足待機は最大25秒です。時間切れになると、timedOutがtrueのHTTP 200が返ります。

    docs / kit / displays

  • c71

    デスクトップ操作のバッチ実行

    デスクトップ操作の一連の流れを、1回のAPI呼び出しで実行します。

    リンクhttps://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/input/batch

    AIに伝える内容
    デスクトップのブラウザーでhoody.comを開く操作を、バッチで実行してください。

    補足バッチは1〜50件の操作を実行し、最初に失敗した時点で止まります。それまでの操作は完了したままで、操作の間にほかの入力が割り込むことがあります。

    docs / kit / displays

  • c72

    操作とキャプチャ

    デスクトップ操作を実行し、その結果を1回の呼び出しでキャプチャします。

    リンクhttps://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/input/act

    AIに伝える内容
    ボタンをクリックし、その結果の画面をキャプチャしてください。

    補足操作のあとでスクリーンショットが失敗しても、操作はすでに完了しています。

    docs / api / displays / input-actions

  • c73

    APIでデスクトップのクリップボード

    1回のAPI呼び出しで、デスクトップのクリップボードのテキストを読み取るか設定します。

    リンクhttps://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/clipboard

    AIに伝える内容
    このアドレスをデスクトップのクリップボードに入れてください。

    docs / api / displays / screenshots

  • c74

    保存済みのデスクトップスクリーンショット

    デスクトップの保存済みスクリーンショットを一覧し、時刻またはファイル名を指定して1枚取得します。

    リンクhttps://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/screenshots

    AIに伝える内容
    10分前のデスクトップのスクリーンショットを見せてください。

    補足検索の対象は、保存されている最新500件のキャプチャです。

    docs / api / displays / screenshots

  • c75

    デスクトップのサムネイル

    ギャラリー用に、デスクトップの小さな画像をキャプチャします。

    リンクhttps://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/thumbnail

    AIに伝える内容
    デスクトップのサムネイルを作ってください。

    補足サムネイルは、画面の縦横を20%に縮小したサイズです。

    docs / api / displays / screenshots

ターミナルとブラウザー 12

  • c06

    リンクで開くターミナル

    どのブラウザーでも、フル機能のターミナルを使えます。SSHキーの設定は不要です。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com

    AIに伝える内容
    コンピューターでターミナルを開いてください。

    補足プロキシの権限を設定するまでは、リンクを知っている人なら誰でもターミナルを使えます。

    docs / kit / terminals

  • c07

    リンクでコマンド実行

    AIがコマンドを実行し、出力とエラーを受け取ります。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/execute

    AIに伝える内容
    テストを実行して、失敗したものを教えてください。

    docs / kit / terminals

  • c08

    全画面のターミナルアプリ

    AIは全画面のターミナルプログラムを、キー単位で操作できます。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com

    AIに伝える内容
    htopを開いて、メモリを一番使っているものを教えてください。

    docs / kit / terminals / automation

  • c09

    ほかのサーバーに接続

    Webターミナルから、ほかのサーバーにSSHで接続できます。クライアントは不要です。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com

    AIに伝える内容
    古いサーバーに接続して、ディスクの空き容量を確認してください。

    docs / kit / terminals

  • c10

    AIが操作するブラウザー

    AIが閲覧、読み取り、クリックできるChromiumまたはFirefoxを実行します。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com

    AIに伝える内容
    料金ページを開いて、プランを表にまとめてください。

    補足初期設定では、1時間使われなかったブラウザーは停止し、タブとCookieが失われます。次の呼び出しでは、新しいブラウザーが起動します。

    docs / kit / browser

  • c11

    ページのスクリーンショットとPDF

    バックグラウンドのブラウザーで、どのWebページもスクリーンショットを撮ったり、PDFとして保存したりできます。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/pdf

    AIに伝える内容
    その記事をPDFで保存してください。

    補足PDFにはバックグラウンドのChromiumが必要です。デフォルトのブラウザーは、画面に表示されるものです。

    docs / kit / browser

  • c76

    独立したターミナルセッション

    コンピューターのファイルとプロセスを共有する、別々のシェルセッションを開きます。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/

    AIに伝える内容
    ビルド用に2つ目のターミナルを開いてください。

    補足新しいセッションには、1〜9999のIDが割り当てられます。4501〜5000のIDはエージェント用に予約されています。同時に動かせる数は、コンピューターのリソースによって決まります。

    docs / kit / terminals

  • c77

    シェルの状態を保持

    関連するコマンドを1つのセッションで実行し、作業ディレクトリと変数を保ちます。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/execute

    AIに伝える内容
    プロジェクトのディレクトリに移動して、そこでビルドを実行してください。

    補足セッションは、削除、コンピューターの再起動、ターミナルサービスの再起動、アイドル時のクリーンアップで終了します。

    docs / kit / terminals

  • c78

    長いコマンドの確認

    長いコマンドを開始し、実行中の出力と状態を確認します。

    AIに伝える内容
    ビルドを開始して、進み具合を確認してください。

    補足保持されるセッションのタイムアウトは、結果を報告する期限です。実行中のコマンドは止まりません。

    docs / kit / terminals

  • c79

    コマンドの停止

    実行中のターミナルコマンドを中断するか、待機中のコマンドを取り消します。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/execute/{command_id}/abort

    AIに伝える内容
    開始したビルドのコマンドを停止してください。

    補足タイムアウト後に中止できるのは、ターミナルにほかの入力が届いておらず、シェルがまだ実行中の間だけです。

    docs / kit / terminals / reference

  • c80

    入力せずに見る

    ターミナルを読み取り専用で開き、入力を送らずにセッションを見守ります。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/?readonly=true

    AIに伝える内容
    ターミナルの閲覧専用リンクをください。

    補足読み取り専用モードで入力が止まるのは、そのクライアントだけです。URLを開ける人は、プロキシの権限で決まります。

    docs / kit / terminals

  • c81

    正確なコマンド出力

    コマンドを実行し、出力のバイト列をそのまま取得します。stdoutとstderrは分かれたままです。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/execute

    AIに伝える内容
    このコマンドを実行して、バイナリ出力をそのまま返してください。

    補足Rawモードはコマンドの終了を待ち、ターミナルセッションの外で実行します。各ストリームは、サーバーの上限まで取得します。

    docs / api / terminal / commands

ターミナルのオプション 10

  • c82

    シェルの選択

    ブラウザーのターミナルを、bash、zsh、fish、sh、tmuxのいずれかで起動します。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/?shell={shell}

    AIに伝える内容
    zshでターミナルを開いてください。

    補足シェルの設定は、セッションの開始時に適用されます。実行中のセッションのシェルを変えるには、reset=trueを付けます。

    docs / kit / terminals / reference

  • c83

    グラフィカルなアプリを起動

    ターミナルをディスプレイと組み合わせ、そのディスプレイ上でプログラムを開きます。

    AIに伝える内容
    ターミナル2から、ディスプレイ2でFirefoxを起動してください。

    補足APIで作成したセッションは、ディスプレイの設定を作成リクエストのボディから読み取ります。

    docs / kit / terminals

  • c84

    SSHでtmuxに参加

    ブラウザーのtmuxセッションに、ターミナル番号を指定してSSHで参加します。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/?shell=tmux

    AIに伝える内容
    ターミナル3にSSHで参加する方法を教えてください。

    docs / kit / terminals

  • c85

    ターミナルのサイドパネル

    Hoody Agent、運用手順書、ダッシュボードを、ターミナルの横に同じページで表示します。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/?panel={url}

    AIに伝える内容
    ターミナル1の横にエージェントを開いてください。

    補足URLを共有すると、ターミナルとパネルが共有されます。

    docs / api / terminal / web-interface

  • c86

    一時的なシェルセッション

    IDが割り当てられ、自動で片付く一時ターミナルを作成します。

    AIに伝える内容
    このスクリプトを一時ターミナルで実行してください。

    補足IDはサービスが5001〜7999から選びます。セッションにディスプレイはありません。完了した結果は、既定で5分間取得できます。

    docs / kit / terminals / reference

  • c87

    ターミナル起動時に実行

    ローカルターミナルのシェルプロンプトが出る前に、起動スクリプトを実行します。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/create

    AIに伝える内容
    ターミナル2の起動時に、セットアップスクリプトを実行してください。

    補足SSHセッションでは、起動スクリプトは実行されません。セッションに選ぶスクリプトは、`..`を含まない絶対パスで指定します。

    docs / kit / terminals / reference

  • c88

    プロキシ経由のSSH

    ターミナルのSSH接続をSOCKS5プロキシ経由にして、ホストに到達します。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/create

    AIに伝える内容
    SOCKS5プロキシ経由でサーバーに接続してください。

    補足SSHホストキーは検証されません。SSHの認証情報とSOCKS5の設定は、作成リクエストのボディに指定します。

    docs / kit / terminals / reference

  • c89

    コマンドの環境変数

    ローカルのターミナルセッションで、1つのコマンドに環境変数を渡します。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/execute

    AIに伝える内容
    DEBUGを1に設定してテストを実行してください。

    補足SSHセッションでは、渡した変数がリモートシェルでexportされ、そのまま残ります。

    docs / api / terminal / commands

  • c90

    ターミナル表示のカスタマイズ

    ターミナルのリンクで、タブのタイトル、フォントサイズ、背景色を設定します。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/

    AIに伝える内容
    ターミナルの文字を大きくし、タブのタイトルを「Build」にしてください。

    補足フォントサイズは8〜72ピクセルです。タブのタイトルは最大200文字です。

    docs / api / terminal / web-interface

  • c91

    スクリーンリーダーモード

    ブラウザーのターミナルのリンクで、スクリーンリーダー対応を有効にします。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/?screenReaderMode=true

    AIに伝える内容
    スクリーンリーダー対応でターミナルを開いてください。

    docs / api / terminal / web-interface

ターミナルの自動化 6

  • c92

    ターミナル出力を待つ

    次の手順の前に、一致するプロンプトが出るか画面が安定するまで待ちます。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/wait

    AIに伝える内容
    Pythonのプロンプトが表示されるまで待ってください。

    補足待機タイムアウトの既定値は5,000msで、10〜300,000msを指定できます。

    docs / kit / terminals / automation

  • c93

    ターミナル画面を検索

    ターミナルの画面とスクロールバックからパターンを検索し、一致した位置を取得します。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/find

    AIに伝える内容
    ターミナルのスクロールバックからエラーメッセージを探してください。

    補足パターンは最大1,024バイトです。検索は最大1,000件を返し、処理時間は500msまでです。

    docs / kit / terminals / automation

  • c94

    ターミナルのコマンド履歴

    セッションに残っているコマンドの記録を、ステータスと終了コードつきで取得します。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/history/{terminal_id}

    AIに伝える内容
    ターミナル1で実行したコマンドを見せてください。

    補足履歴は既定で直近100件までで、古いものから入れ替わります。全件の記録が必要な場合は、そのつど取得してください。

    docs / kit / terminals / reference

  • c95

    ターミナル出力のエクスポート

    残っているターミナル出力をダウンロードするか、末尾の行をテキストまたはHTMLで取得します。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/raw

    AIに伝える内容
    ターミナル1の最新の出力をダウンロードしてください。

    補足出力は既定で最大8MBまで保持し、古いものから削除します。

    docs / kit / terminals / reference

  • c96

    ターミナルのスクリーンショット

    ターミナルの出力を画像にして、チュートリアルやダッシュボードに使えます。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/screenshot

    AIに伝える内容
    ターミナルのスクリーンショットをPNGで保存してください。

    補足PNG、JPEG、GIFから選びます。画像は既定で保存もされます。

    docs / kit / terminals / reference

  • c97

    ターミナルのマウス入力

    マウスレポートに対応したターミナルのプログラムで、クリックやスクロールをします。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/mouse

    AIに伝える内容
    ターミナルのプログラムでメニュー項目をクリックしてください。

    補足プログラムがマウスイベントを受け取るのは、マウスレポートを有効にした場合だけです。HTTPでは、1リクエストにつき最大256件のイベントを受け付けます。

    docs / kit / terminals / automation

Webページを読む 8

  • c98

    ページをMarkdownで取得

    Webページを、タイトルとメタデータつきのMarkdownに変換します。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/markdown

    AIに伝える内容
    この記事をMarkdownで読んでください。

    補足変換されるのはメインフレームだけです。iframeの内容とshadow DOMは含まれません。

    docs / api / browser / interaction

  • c99

    記事本文の抽出

    ナビゲーション、サイドバー、コメントを除いた、ページの本文を取得します。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/markdown

    AIに伝える内容
    このページから記事の本文を抽出してください。

    補足変換されるのはメインフレームだけです。iframeの内容とshadow DOMは含まれません。

    docs / api / browser / interaction

  • c100

    ページのHTMLまたはテキスト

    ブラウザーのタブのHTML全体、または表示されているテキストだけを取得します。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/html

    AIに伝える内容
    このタブのHTMLを見せてください。

    docs / kit / browser

  • c101

    ページのリンクを収集

    ページ内のリンクを、並べ替えて重複を除いた一覧で取得します。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/markdown

    AIに伝える内容
    この記事のリンクを一覧にしてください。

    補足links配列は最大10,000件です。変換されるのはメインフレームだけです。

    docs / api / browser / interaction

  • c102

    ページのJavaScriptを実行

    ブラウザーのタブでJavaScriptを実行し、結果を受け取ります。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/eval

    AIに伝える内容
    JavaScriptを実行して、ページのタイトルを読み取ってください。

    補足既定のステルスインスタンスでは、スクリプトは分離されたワールドで実行され、ページのグローバル変数を読めません。タイムアウトの既定値と最大値は30,000msです。

    docs / kit / browser

  • c103

    要素1つのスクリーンショット

    表示中のページ要素を1つ、その要素のサイズのままキャプチャします。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/screenshot

    AIに伝える内容
    このページのグラフだけをキャプチャしてください。

    補足selectorは最初に一致した要素をキャプチャします。clipやfullPage=trueとは併用できません。

    docs / api / browser / interaction

  • c104

    スクリーンショットの情報を隠す

    スクリーンショット内の選んだページ要素を、不透明なボックスで覆います。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/screenshot

    AIに伝える内容
    このスクリーンショットの口座番号を隠してください。

    補足マスキングはiframe内の要素には効きません。selectorが何にも一致しなくても成功として返るため、画像を確認してください。

    docs / api / browser / interaction

  • c105

    ページのアクセシビリティスナップショット

    要素の参照つきで、ページの構造化スナップショットを取得します。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/snapshot

    AIに伝える内容
    このページのアクセシブルなコントロールを見せてください。

    補足参照は、新しいスナップショットを取るか、トップドキュメントが移動すると失効します。入力済みのフォーム値は、既定で非表示です。

    docs / api / browser / interaction

ブラウザー操作 15

  • c106

    ブラウザー自動化の接続

    PlaywrightまたはPuppeteerのクライアントを、HoodyのChromiumインスタンスに接続します。

    リンクhttps://{p}-{c}-cdp-1.{node}.computers.hoody.com/

    AIに伝える内容
    PlaywrightのスクリプトをHoodyのブラウザーに接続してください。

    補足リモートデバッグを有効にしたChromiumが必要です。Firefoxでは501が返ります。

    docs / kit / browser

  • c107

    ブラウザーセッションの分離

    タブとCookieがそれぞれ独立したブラウザーインスタンスを、別々に実行します。

    AIに伝える内容
    これらのサイト用に、ブラウザーセッションを2つ別々に開いてください。

    補足既定では、1時間使われなかったインスタンスは停止し、タブとCookieは破棄されます。

    docs / kit / browser

  • c108

    ページの変化を待つ

    ページにテキストが表示されるか、URLに到達するか、読み込みが終わるまで待ちます。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/wait

    AIに伝える内容
    ページに注文の確定が表示されるまで待ってください。

    補足タイムアウトは既定で10,000ms、最大で30,000msです。この呼び出しではブラウザーは起動しません。

    docs / kit / browser / reference

  • c109

    ページのダイアログを処理

    ブラウザーの操作で表示されたページのダイアログを、承諾または却下します。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/action

    AIに伝える内容
    削除をクリックし、確認ダイアログを承諾してください。

    補足ポリシーが対象とするのは、操作によって最初に表示された該当ダイアログです。想定外のダイアログは閉じられ、操作は失敗します。

    docs / kit / browser

  • c110

    ブラウザーのタブを管理

    開いているブラウザーのタブをポップアップも含めて一覧にし、不要になったものを閉じます。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/tabs

    AIに伝える内容
    ブラウザーの古いショッピングのタブを閉じてください。

    補足最後に開いているタブは閉じられません。

    docs / kit / browser

  • c111

    ブラウザーのCookie

    ブラウザーインスタンスのCookieを読み取り、追加、削除します。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/cookies

    AIに伝える内容
    このサイトのCookieを見せてください。

    補足追加したCookieに無効なものが1つでもあると、どれも設定されません。インスタンスを停止すると、Cookieは破棄されます。

    docs / kit / browser

  • c112

    ブラウザーの地域を設定

    ブラウザーの起動時に、ロケール、タイムゾーン、位置情報を設定します。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/start

    AIに伝える内容
    ロンドンのタイムゾーンでブラウザーを起動してください。

    補足これらのオプションは、インスタンスの作成時にだけ有効です。

    docs / kit / browser

  • c113

    プロキシ経由のブラウザー

    ブラウザーの通信を、HTTPまたはSOCKSプロキシ経由にします。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/start

    AIに伝える内容
    プロキシ経由でブラウザーを起動してください。

    補足proxyオプションは、インスタンスの作成時にだけ有効です。

    docs / kit / browser

  • c114

    Chromium拡張機能

    広告ブロッカーなどのChromium拡張機能を、ブラウザーに読み込みます。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/start

    AIに伝える内容
    広告ブロッカーを入れてChromiumを起動してください。

    補足拡張機能には、表示されるChromiumインスタンスが必要です。設定は、インスタンスの作成時に行います。

    docs / kit / browser

  • c115

    Chromeバージョンの固定

    ブラウザーインスタンスで使うChromeのバージョンまたはチャンネルを選びます。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/start

    AIに伝える内容
    Chrome 136でブラウザーを起動してください。

    補足起動オプションは、インスタンスの作成時にだけ有効です。メジャーバージョンを解決できなかった場合は指定なしとして扱われるため、メタデータのbrowserFullVersionを確認してください。

    docs / kit / browser

  • c116

    ブラウザーの履歴

    ブラウザーの履歴を日付またはドメインで確認するか、削除します。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/history

    AIに伝える内容
    10月より前のブラウザー履歴を削除してください。

    補足履歴は既定で30日間保持され、再起動しても残ります。削除すると元に戻せません。

    docs / kit / browser

  • c117

    ブラウザーのコンソールログ

    ブラウザーの直近のコンソールメッセージとページのエラーを確認します。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/console

    AIに伝える内容
    テストページのコンソールエラーを見せてください。

    補足直近500件を保持します。既定のステルスインスタンスが取得するのは、ブラウザーが報告したメッセージだけです。ページのconsole呼び出しや、キャッチされなかったエラーは含みません。

    docs / api / browser / health

  • c118

    ブラウザーのネットワークログ

    ブラウザーの全タブで、直近のネットワークリクエストとレスポンスを確認します。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/network

    AIに伝える内容
    テストページのネットワークリクエストを見せてください。

    補足直近500件を保持します。

    docs / api / browser / health

  • c119

    ブラウザーのDevToolsを開く

    ChromiumインスタンスをDevToolsで調べるためのリンクを取得します。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/devtools-url

    AIに伝える内容
    ブラウザーのDevToolsを開いてください。

    補足FirefoxまたはChromiumのリモートデバッグが無効な場合、DevTools Protocolは使えません。

    docs / kit / browser

  • c120

    ブラウザーのタブをリサイズ

    実行中のブラウザーの全タブに、固定のビューポートサイズを設定します。

    リンクhttps://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/viewport

    AIに伝える内容
    ブラウザーのタブを1280×800にリサイズしてください。

    補足幅と高さは1〜8,192の整数です。クラッシュしたタブは対象外になります。

    docs / api / browser / control

ファイルとデータ 8

  • c12

    リンクで開くファイル

    Webファイルマネージャーで、ファイルを閲覧、編集、ダウンロードできます。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com

    AIに伝える内容
    プロジェクトフォルダーのファイルを見せてください。

    補足プロキシの権限を設定するまでは、リンクを知っている人なら誰でもファイルを見たり変更したりできます。

    docs / kit / files

  • c13

    クラウドドライブを一か所に

    Google Drive、Dropbox、S3など、49種類のリモートストレージを接続できます。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com

    AIに伝える内容
    Dropboxの請求書をプロジェクトにコピーしてください。

    docs / kit / files

  • c14

    ファイル履歴

    リンク経由で変更した小さなテキストファイルを、以前のバージョンに戻せます。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com

    AIに伝える内容
    config.jsonの昨日のバージョンを見せてください。

    補足Hoody Files経由で変更された2MiBまでのテキストファイルが対象です。90日間、または履歴が2GiBに達するまで保持されます。ビルドフォルダーとURLからのダウンロードは対象外です。記録はベストエフォートのため、バックアップではありません。

    docs / kit / files

  • c15

    ノートパソコンのファイル

    コンピューターのファイルを、FinderやExplorerで開けます。

    AIに伝える内容
    HoodyのファイルをMacにマウントしてください。

    補足プロキシの権限を設定するまでは、WebDAVリンクを知っている人なら誰でもファイルをマウントできます。

    docs / foundation / storage / mount-locally

  • c16

    ノートパソコンのフォルダーを取り込む

    ノートパソコンのフォルダーを、コンピューターの中に表示できます。

    AIに伝える内容
    DownloadsフォルダーをHoodyのコンピューターと共有してください。

    補足rclone 1.61以降を使うLinuxまたはmacOSで利用できます。Windowsにはまだ対応していません。フォルダーが使えるのは、マシンがオンラインで、コマンドが実行されている間だけです。停止すると、保留中の書き込みを送り終えるまで待ちます。

    docs / foundation / storage / share-local-folder

  • c17

    コンピューター間で共有するフォルダー

    同じサーバー上のコンピューター間で、フォルダーを共有できます。読み取り専用と読み書き可能から選べます。

    AIに伝える内容
    このプロジェクトのすべてのコンピューターと、assetsフォルダーを共有してください。

    補足同じサーバー上のコンピューター間で使えます。サーバーをまたぐ場合は試験提供で、初期設定ではオフです。

    docs / foundation / storage / sharing-files

  • c18

    サーバーなしのデータベース

    SQLデータベースとキーバリュー形式のデータを保存し、リンクからアクセスできます。

    リンクhttps://{p}-{c}-sqlite-1.{node}.computers.hoody.com

    AIに伝える内容
    読書リスト用のデータベースを作ってください。

    補足プロキシの権限を設定するまでは、リンクを知っている人なら誰でもデータベースにアクセスできます。

    docs / kit / sqlite

  • c19

    データを元に戻す

    保存したキーバリュー形式のデータの過去の変更を、確認して元に戻せます。

    リンクhttps://{p}-{c}-sqlite-1.{node}.computers.hoody.com

    AIに伝える内容
    設定の直前の変更を元に戻してください。

    補足記録されるのは、キーバリューAPI経由の変更だけです。SQLでの書き込みと、履歴をオフにして送った書き込みは、元に戻せません。

    docs / kit / sqlite

リンクで使うファイルツール 17

  • c121

    URLからダウンロード

    手元のデバイスを経由せず、リモートのファイルをコンピューターに直接取り込みます。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com/{folder}?download={url}

    AIに伝える内容
    このデータセットをコンピューターに直接ダウンロードしてください。

    補足ダウンロードは100GiBまたは12時間で停止します。

    docs / kit / files

  • c122

    ファイルのコピーと移動

    Files APIで、ファイルとフォルダーをコピーまたは移動します。

    AIに伝える内容
    レポートをアーカイブフォルダーにコピーしてください。

    補足移動で既存の移動先が置き換えられることはありません。コピーが置き換えるのは、`?overwrite=true`を付けた場合だけです。

    docs / kit / files

  • c123

    アーカイブの中身を見る

    展開せずに、アーカイブの内容を一覧にするか、ファイルを1つ読み取ります。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com/{archive}?preview

    AIに伝える内容
    このアーカイブのファイルを一覧にして、READMEを見せてください。

    補足ZIP、TAR、圧縮TARのアーカイブに対応します。選択したファイルが100MBを超える場合は受け付けません。

    docs / api / files / directories

  • c124

    画像のリサイズと変換

    リンクを指定して、画像のリサイズ、変換、ぼかし、グレースケール化をします。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com/{image}?thumbnail&size={size}&format={format}

    AIに伝える内容
    この写真から、256ピクセルのWebPサムネイルを作ってください。

    補足JPEG、PNG、WebP、GIF、BMPに対応し、2,000×2,000ピクセルの枠まで扱えます。ぼかしの半径は0〜50です。

    docs / api / files / file-operations

  • c125

    指定した行を読む

    リンクを指定して、ファイルの行の範囲または末尾の行を読み取ります。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/{path}?lines={range}

    AIに伝える内容
    このログの最後の20行を見せてください。

    補足1リクエストあたり最大100,000行または64MBです。

    docs / api / files / reading

  • c126

    読み取り専用のファイルページ

    編集用のコントロールがないページで、テキストファイルを開きます。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com/{path}?view

    AIに伝える内容
    このノートを読み取り専用で開いてください。

    補足このビューは、ほかのリクエストによる書き込みを防ぎません。アクセスを制御するには、プロキシの権限を設定してください。

    docs / kit / files

  • c127

    ファイルのリビジョンを比較

    記録されたファイルの2つのバージョンの差分を確認します。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/{path}?diff&from_seq={from_seq}&to_seq={to_seq}

    AIに伝える内容
    この2つのリビジョンの変更点を見せてください。

    補足履歴の対象は、Files経由で行った変更です。2MiBを超えるファイルとバイナリファイルには差分が残りません。履歴は、90日を過ぎるか2GiBを超えると整理されます。

    docs / kit / files

  • c128

    ファイルに追記

    リンクを指定して、ファイルの末尾にデータを追加します。ファイルがなければ作成します。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/append/{path}

    AIに伝える内容
    このエントリをログファイルに追記してください。

    docs / api / files / file-operations

  • c129

    アーカイブから1件を取り出す

    アーカイブの残りはそのままに、ファイルまたはフォルダーを1つ取り出します。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com/{archive}?extract_file&extract={member}

    AIに伝える内容
    このアーカイブからimagesフォルダーだけを取り出してください。

    補足ZIP、TAR、圧縮TARのアーカイブに対応します。

    docs / api / files / directories

  • c130

    ファイルの範囲指定ダウンロード

    ファイル全体ではなく、指定したバイト範囲だけをリクエストします。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/{path}

    AIに伝える内容
    このファイルの先頭1MBを取得してください。

    補足`backend`で指定したリモートファイルに複数の範囲を指定すると、ファイル全体が返ります。

    docs / api / files / reading

  • c131

    リンクで確認するファイル情報

    内容をダウンロードせずに、ファイルのサイズ、所有者、権限を確認します。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/stat/{path}

    AIに伝える内容
    このファイルのサイズと所有者を確認してください。

    docs / api / files / file-operations

  • c132

    ファイルの整合性を確認

    ファイルのSHA-256ハッシュを手元のコピーと比べて、ダウンロードを確かめます。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/{path}?hash

    AIに伝える内容
    ダウンロードしたバックアップが元のファイルと一致するか確認してください。

    docs / kit / files

  • c133

    URLダウンロードの管理

    コンピューターのURLダウンロードについて、進捗の確認、履歴の確認、キャンセルができます。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/downloads

    AIに伝える内容
    実行中のダウンロードを表示して、止まっているものをキャンセルしてください。

    補足キャンセルには、ルートへの書き込み権限が必要です。キャンセルされた途中のファイルは、マウントまたはネットワークファイルシステム上に残ります。

    docs / api / files / downloading

  • c134

    アーカイブ展開の進捗確認

    実行中のアーカイブ展開の進捗を確認するか、キャンセルします。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/extractions

    AIに伝える内容
    アーカイブがまだ展開中か確認してください。

    補足展開のキャンセルには、ルートフォルダーへの書き込み権限が必要です。

    docs / api / files / directories

  • c135

    ファイル変更の監査

    コンピューター全体で記録されたファイルの変更を、パス、操作、時刻で検索します。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/journal

    AIに伝える内容
    今日このフォルダーで記録されたファイルの削除を見せてください。

    補足ジャーナルに記録されるのは、Hoody Filesで行った変更です。ターミナルのコマンド、スクリプト、プログラムによる変更は記録されません。

    docs / kit / files

  • c136

    条件つきのファイル書き込み

    ファイルのバージョンが想定したバージョンと一致するときだけ書き込みます。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/{path}

    AIに伝える内容
    読み込んだ後に誰も変更していない場合だけ保存してください。

    補足対象はコンピューター上のファイルです。接続したクラウドストレージ上のファイルには使えません。

    docs / api / files / file-operations

  • c137

    アップロード時の権限設定

    新しいファイルをアップロードするときに、権限ビットを設定します。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/{path}?chmod={mode}

    AIに伝える内容
    このキーを所有者のみの権限でアップロードしてください。

    補足`GET /api/v1/version`の`features`に`put_chmod`が含まれることを確認してください。古いサービスは`?chmod`を無視します。

    docs / kit / files

クラウドと共有ストレージ 11

  • c138

    リモートストレージをフォルダーとして使う

    接続したストレージアカウントをマウントし、プログラムからフォルダーとして使えるようにします。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/mounts

    AIに伝える内容
    接続したDriveをマウントして、プログラムから使えるようにしてください。

    補足書き込みは、`write_back`で指定した時間(既定は5秒)の後にアップロードされます。1つのファイルに2か所から書き込むと、最後のアップロードが残ります。

    docs / kit / files

  • c139

    複数のクラウドアカウント

    同じストレージプロバイダーの個人用アカウントと仕事用アカウントを接続します。

    AIに伝える内容
    個人用と仕事用、両方のGoogle Driveを接続してください。

    補足接続数は既定で、全体で100、リモートホストごとに10までです。

    docs / foundation / storage / cloud

  • c140

    クラウドプロバイダー間でコピー

    コンピューターの帯域幅を使って、接続したプロバイダー間でファイルをコピーします。

    AIに伝える内容
    このDriveのバックアップをS3バケットにコピーしてください。

    補足ファイルは、コンピューター上の一時コピーを経由します。

    docs / foundation / storage / cloud

  • c141

    ファイルサーバーを接続

    SFTP、SMB、WebDAV、FTP、HDFS、HTTPのサーバーをコンピューターに接続します。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/backends/{protocol}

    AIに伝える内容
    チームのSMBファイルサーバーを接続してください。

    補足接続時にログイン情報を確認します。その後、フォルダーとしてマウントします。

    docs / api / files / mount / protocols

  • c142

    スマートフォンにマウント

    スマートフォンのWebDAVアプリから、コンピューターのファイルを開きます。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com/

    AIに伝える内容
    コンピューターのファイルをスマートフォンのファイルアプリで開いてください。

    補足プロキシの権限を設定するまでは、WebDAVリンクを知っている人なら誰でもファイルをマウントできます。

    docs / foundation / storage / mount-locally

  • c143

    単発のリモートファイル

    ストレージ接続を保存せずに、リモートファイルを読み取り、アップロードします。

    AIに伝える内容
    SFTPサーバーのこのファイルを1回だけ読み取ってください。

    補足SFTP、WebDAV、FTP、S3で使えます。

    docs / kit / files

  • c144

    読み取り専用のノートパソコンフォルダー

    ノートパソコンのフォルダーを、書き込みから保護したままコンピューターで読み取れます。

    AIに伝える内容
    ドキュメントフォルダーを読み取り専用でコンピューターと共有してください。

    補足rclone 1.61以降を使うLinuxまたはmacOSが必要です。共有は、マシンがオンラインでコマンドを実行している間だけ使えます。

    docs / foundation / storage / share-local-folder

  • c145

    有効期限付きのフォルダー共有

    別のコンピューターと共有したフォルダーに、有効期限を設定します。

    リンクhttps://api.hoody.com/api/v1/computers/{id}/storage/shares

    AIに伝える内容
    このフォルダーを金曜日まで別のコンピューターと共有してください。

    補足有効期限が切れると、共有は削除され、すべての対象からマウント解除されます。

    docs / foundation / storage / sharing-files

  • c146

    受信した共有を承認

    別のコンピューターから届いたフォルダー共有を、承認またはオフにします。

    リンクhttps://api.hoody.com/api/v1/computers/{id}/storage/incoming/{shareId}/mount

    AIに伝える内容
    共有assetsフォルダーのマウントを、このコンピューターで停止してください。

    補足共有をマウントするには、作成者側のenabledフラグと受信側のmountフラグの両方がtrueである必要があります。

    docs / api / storage-shares

  • c147

    読み取り専用のクラウドマウント

    マウントしたリモートフォルダーが、マウントパス経由の書き込みを受け付けないようにします。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/mounts/{id}

    AIに伝える内容
    マウントしたクラウドフォルダーを読み取り専用にしてください。

    補足`?backend=`経由のルートでは、引き続き書き込めます。`box`、`onedrive`、`protondrive`ではカスタム設定に対応していません。

    docs / kit / files / reference

  • c148

    アップロードに失敗したファイル

    クラウドマウントからアップロードできなかったファイルを探し、保留中のコピーをダウンロードします。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/pending-uploads

    AIに伝える内容
    クラウドストレージにまだ届いていないファイルを表示してください。

    補足保留中のファイルは、配信または破棄するまで残ります。保留中のコピーは、不完全な場合があります。

    docs / kit / files

データベースとキーバリュー 13

  • c149

    SQLトランザクション

    複数のSQL文をまとめて実行し、1つでも失敗したらすべてロールバックします。

    リンクhttps://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/db

    AIに伝える内容
    注文とその在庫を、1つのトランザクションで更新してください。

    補足結果セットは10,000行で打ち切られ、truncated: trueが返ります。続きはLIMITでページ分割して取得します。

    docs / kit / sqlite

  • c150

    ライブクエリを共有

    読み取り専用のSQLクエリを最新のデータに対して実行するリンクを共有します。

    リンクhttps://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/query

    AIに伝える内容
    現在の注文数を表示するリンクを作ってください。

    補足URLには、Base64URLでエンコードした読み取り専用のSELECTを1つ含めます。

    docs / kit / sqlite

  • c151

    ネイティブとHTTPのSQLite

    SQLiteデータベースを、ローカルのコードとHTTPの両方から同時に使えます。

    AIに伝える内容
    ローカルのワーカーとダッシュボードで、同じデータベースを使えるようにしてください。

    補足SQLiteは、データベースファイル1つにつき、同時に書き込めるのは1つだけです。ストレージ共有を通じて、データベースファイルを複数のコンピューターで共有しないでください。

    docs / foundation / storage / sqlite-drive

  • c152

    データベースのバックアップコピー

    使用中のSQLiteデータベースの、整合性の取れたコピーを作成します。

    リンクhttps://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/maintenance

    AIに伝える内容
    データベースの整合性の取れたバックアップを作成してください。

    補足コピーは新しいパスに書き込まれます。

    docs / kit / sqlite

  • c153

    データベースの変更を追跡

    キーバリューテーブルの変更を、SQLでの書き込みも含めて、発生と同時にストリーミングします。

    リンクhttps://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/changes/stream

    AIに伝える内容
    アプリのデータベースでキーが変更されるたびに知らせてください。

    補足ログは24時間分、最大1,000,000件の変更まで保持します。

    docs / kit / sqlite

  • c154

    一時キーの有効期限を設定

    保存したキーに有効期限を設定します。あとから変更もできます。

    リンクhttps://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/kv/{key}/expire

    AIに伝える内容
    このセッションキーを1時間後に失効させてください。

    docs / kit / sqlite

  • c155

    競合しないカウンター

    多数のクライアントから共有カウンターを加算しても、更新は失われません。

    リンクhttps://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/kv/{key}/incr

    AIに伝える内容
    ホームページへのアクセスを1回ずつカウントしてください。

    docs / kit / sqlite

  • c156

    JSONフィールドを更新

    保存したJSON値の一部を、読み取り、書き込み、加算できます。

    AIに伝える内容
    ほかの設定は置き換えずに、themeフィールドだけを変更してください。

    補足パスを指定して設定する場合、保存する値にはJSONのコンテンツタイプが必要です。

    docs / kit / sqlite

  • c157

    書き込みの競合を防止

    共有キーを、バージョンが変わっていない場合にだけ更新します。

    リンクhttps://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/kv/{key}

    AIに伝える内容
    先にだれも変更していない場合にだけ、設定を更新してください。

    補足412は、別のクライアントが先に書き込んだことを示します。読み直してから、変更をやり直してください。

    docs / kit / sqlite

  • c158

    キーをファイルとして保存

    キーをディレクトリに保存し、ほかのツールからファイルとして編集できます。

    AIに伝える内容
    これらの設定をディレクトリにファイルとして保存してください。

    docs / kit / sqlite

  • c159

    SQL値の一括処理

    1つのSQL文を、複数の値セットに対して実行します。

    リンクhttps://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/db

    AIに伝える内容
    これらの行を1つのSQL文で挿入してください。

    docs / kit / sqlite

  • c160

    キー操作の一括処理

    1回のリクエストで、最大100個のキーを読み取り、書き込み、削除できます。

    AIに伝える内容
    これらの設定をまとめて保存してください。

    補足バッチ書き込みは、すべてのキーに反映されるか、どれも反映されないかのどちらかです。

    docs / kit / sqlite

  • c161

    競合しないリスト

    保存したリストへの追加、取り出し、削除を、クライアント間で競合させずに行えます。

    AIに伝える内容
    この商品を共有ショッピングカートに追加してください。

    docs / kit / sqlite

サイト、スクリプト、リンク 10

  • c20

    スクリプトがエンドポイントに

    JavaScriptまたはTypeScriptのファイルをスクリプトフォルダーに保存すると、すぐに使えるWebエンドポイントになります。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/<script>

    AIに伝える内容
    CSVをJSONに変換するエンドポイントを書いてください。

    docs / kit / exec

  • c21

    スクリプト内のAI

    スクリプトからAIモデルを呼び出せます。キーの設定は不要です。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/<script>

    AIに伝える内容
    Webページを要約するエンドポイントを作ってください。

    補足初期設定のモデルは、サーバーの上限内なら無料です。有料モデルは、使った分だけ請求されます。

    docs / kit / exec / ai-integration

  • c22

    非公開エンドポイント

    スクリプトのエンドポイントは、それぞれ専用のシークレットトークンで保護できます。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/<script>

    AIに伝える内容
    そのエンドポイントをロックして、自分のアプリだけが呼び出せるようにしてください。

    docs / kit / exec / authentication

  • c23

    スクリプトのライブイベント

    実行中のスクリプトから、どのページへもイベントをリアルタイムで配信します。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/<script>

    AIに伝える内容
    注文の更新をダッシュボードにリアルタイムで送ってください。

    補足スクリプトごとにオンにします。イベントは保存されないため、ページが受け取れるのは、接続中に送られたイベントだけです。非公開のデータを送る前に、トークンかプロキシの権限を追加してください。

    docs / kit / exec / remote

  • c24

    サイトとアプリを公開

    実行したHTTPアプリは、それぞれ専用のHTTPSリンクで動きます。デプロイの手順は不要です。

    リンクhttps://{p}-{c}-http-8080.{node}.computers.hoody.com

    AIに伝える内容
    ランディングページを作って、リンクを送ってください。

    補足プロキシの権限を設定するまでは、リンクを知っている人なら誰でも開けます。

    docs / concepts / everything-is-a-url

  • c25

    カスタムドメイン

    所有するドメインでサイトやツールを公開できます。HTTPSも含まれます。

    リンクhttps://www.yourdomain.com

    AIに伝える内容
    サイトをwww.example.comで公開してください。

    補足対象はサブドメインのみです。www.example.comは使えますが、example.comは使えません。サブドメインごとに短いリンクを指定します。複数のサブドメインで1つのリンクを共有することもできます。

    docs / foundation / proxy / connect-domain

  • c26

    短いリンク

    サイトやツールに、覚えやすい短いリンクを付けられます。

    リンクhttps://{alias}.{node}.computers.hoody.com

    AIに伝える内容
    ダッシュボードに短いリンクを付けてください。

    補足短いリンクは推測されやすく、プロキシの権限を設定するまで誰でも開けます。Freeプランはサーバー1台あたり3つ、Plusプランは50つ、Proプランは250つです。

    docs / foundation / proxy / aliases

  • c162

    有効期限付きのデモリンク

    デモやイベント用のリンクに、有効期限を設定します。

    リンクhttps://api.hoody.com/api/v1/proxy/aliases

    AIに伝える内容
    このデモリンクを金曜日に失効させてください。

    補足有効期限が切れたエイリアスは404を返し、設定は残ります。無効のエイリアスと期限切れのエイリアスも、サーバーのエイリアス数の上限に含まれます。

    docs / foundation / proxy / aliases

  • c163

    リンクを1ページに固定

    エイリアスが、固定した1つのページまたはAPIエンドポイントを開くようにします。

    リンクhttps://api.hoody.com/api/v1/proxy/aliases

    AIに伝える内容
    このリンクでレポートページだけが開くようにしてください。

    補足パスの上書きを無効にすると、ほかのパスは404を返します。メソッド、ボディ、WebSocketアップグレード、そのほかのパラメーターはそのまま通ります。

    docs / foundation / proxy / aliases

  • c164

    短いリンクを一時停止

    エイリアスを無効にし、設定を保ったまま、あとで元に戻せます。

    リンクhttps://api.hoody.com/api/v1/proxy/aliases/{id}/state

    AIに伝える内容
    デモリンクを明日まで一時停止してください。

    補足無効の間、URLは404を返します。変更がエイリアスのURLに反映されるまで約30秒かかり、それ以上かかる場合もあります。

    docs / foundation / proxy / aliases

スクリプトの作成 12

  • c165

    スクリプト内のパッケージ

    npmパッケージをインポートすると、スクリプトの実行前にインストールが済みます。

    AIに伝える内容
    スクリプトでaxiosを使って、そのAPIを呼び出してください。

    補足最初のリクエストは遅くなり、コンピューターからnpmレジストリに接続できる必要があります。計算で組み立てたパッケージ名は検出されません。

    docs / kit / exec / writing-scripts

  • c166

    動的なスクリプトルート

    URLパスから値を取り出し、スクリプトで使えます。

    AIに伝える内容
    URLからIDを読み取るユーザーエンドポイントを作ってください。

    docs / kit / exec / routing

  • c167

    構造化されたAI応答

    決まったJSON形式でAIの出力を返すよう、スクリプトから要求できます。

    AIに伝える内容
    このテキストから名前と日付をJSONで抽出してください。

    補足Zodスキーマはレスポンスを自動で検証します。`jsonSchema(...)`スキーマは、`validate`関数を渡さない限り、モデルに送られるだけです。

    docs / kit / exec / ai-integration

  • c168

    AI応答をストリーミング

    応答の生成と同時に、スクリプトからテキストをストリーミングします。

    AIに伝える内容
    AIエンドポイントの回答を、生成と同時にストリーミングしてください。

    docs / kit / exec / ai-integration

  • c169

    スクリプトのWebSocketサーバー

    自作のワーカースクリプトで、WebSocket接続を受け付けます。

    AIに伝える内容
    チャットアプリ用のWebSocketエンドポイントを作ってください。

    補足WebSocketには、`// @mode worker`と`// @websocket`の両方が必要です。

    docs / kit / exec / execution-modes

  • c170

    スクリプトのリクエストミドルウェア

    フォルダー内のスクリプトへのリクエストの前後で、自分のコードを実行します。

    AIに伝える内容
    APIフォルダーのスクリプトに、リクエストのログ記録を追加してください。

    docs / kit / exec / routing

  • c171

    スクリプトの環境変数

    スクリプト、フォルダー、またはscriptsルートに、環境変数を設定します。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/env/update

    AIに伝える内容
    請求書スクリプトのAPIキーを設定してください。

    補足変更の競合を防ぐため、リクエストには現在のファイルのリビジョンが必要です。

    docs / api / exec / script-management

  • c172

    スクリプト共有キャッシュ

    スクリプトへのリクエストをまたいで、一時的な値を保持します。

    AIに伝える内容
    最新の為替レートを、リクエスト間でキャッシュしてください。

    補足再起動すると完全に失われ、クリアやアイドル時の退避でも空になります。

    docs / kit / exec

  • c173

    リクエストごとに新しいコンテキスト

    独立したタスクのために、リクエストごとに新しいJavaScriptコンテキストで実行します。

    AIに伝える内容
    このWebhook受信スクリプトが、リクエストごとに新しいコンテキストを使うようにしてください。

    補足新しいコンテキストで分離されるのは変数だけで、副作用は分離されません。書き込んだファイル、起動したサブプロセス、行ったネットワーク呼び出しは残ります。

    docs / kit / exec / execution-modes

  • c174

    テンプレートから生成

    組み込みまたはカスタムのテンプレートから、スクリプトを生成します。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/templates/generate

    AIに伝える内容
    テンプレートから新しいスクリプトを生成してください。

    docs / api / exec / templates

  • c175

    実行前にスクリプトを検査

    スクリプトの構文、依存関係、ディレクティブ、任意の型を、1回の呼び出しで検査します。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/validate/script

    AIに伝える内容
    保存する前に、このスクリプトにエラーがないか検査してください。

    docs / api / exec / validation

  • c176

    スクリプトの依存関係を固定

    スクリプトの依存関係のバージョンを、パッケージマニフェストで固定します。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/package/pin

    AIに伝える内容
    スクリプトが使う依存関係のバージョンを固定してください。

    docs / api / exec / package-management

スクリプトの実行 8

  • c177

    スクリプトのバージョン履歴

    スクリプトを以前のバージョンに戻せます。控えを残してあれば、削除したスクリプトも復元できます。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/scripts/restore

    AIに伝える内容
    Webhookスクリプトを前のバージョンに復元してください。

    補足削除したスクリプトを復元できるのは、`keepCopy=true`を付けて削除した場合だけです。

    docs / api / exec / script-management

  • c178

    スクリプトのログを検索

    スクリプトのログを、テキストまたは正規表現で検索します。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/logs/search

    AIに伝える内容
    スクリプトのログからタイムアウトエラーを探してください。

    docs / api / exec / logs

  • c179

    スクリプトのパフォーマンス履歴

    スクリプトの呼び出し回数、失敗数、レイテンシを1時間ごとに確認できます。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/monitor/script-usage

    AIに伝える内容
    今日、Webhookが遅かった時間帯を表示してください。

    補足履歴は直近24時間分です。

    docs / api / exec / monitoring

  • c180

    実行中のスクリプトにメッセージを送信

    実行中のスクリプトにメッセージを送り、ハンドラーの返信を受け取ります。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/{path}

    AIに伝える内容
    実行中のビルドスクリプトに、開始メッセージを送ってください。

    補足スクリプトで`@remote-messages`を有効にします。リモート操作ではディレクトリのミドルウェアが実行されないため、トークンで保護してください。

    docs / kit / exec / remote

  • c181

    公開された関数を呼び出し

    実行中のスクリプトが公開している関数を呼び出し、その応答を受け取ります。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/{path}

    AIに伝える内容
    実行中のワーカーのstatus関数を呼び出してください。

    補足スクリプトで`@remote-call`を有効にします。リモート操作ではディレクトリのミドルウェアが実行されないため、トークンで保護してください。

    docs / kit / exec / remote

  • c182

    実行中のスクリプトを調査

    デバッグ中に、スクリプトの直近の実行に対して式を評価します。

    AIに伝える内容
    実行中のワーカーのカウンターを調べてください。

    補足`@remote-eval`と、`eval`スコープを持つ`@remote-token`が必要です。`@token`では使えるようになりません。

    docs / kit / exec / remote

  • c183

    スクリプトのスケジュール履歴

    過去のスケジュール実行を確認し、スクリプトや時間帯で絞り込めます。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/schedules/history

    AIに伝える内容
    スケジュール設定したレポートスクリプトの実行時刻を表示してください。

    docs / api / exec / scheduling

  • c184

    スクリプトルートをテスト

    複数のURLパスを、スクリプトのルーティングルールに対してまとめて確認します。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/route/test

    AIに伝える内容
    これらのURLパスを処理するスクリプトを確認してください。

    docs / api / exec / routing

自動で動く 17

  • c27

    動き続けるプログラム

    サーバーやワーカーを実行します。クラッシュしても自動で再起動します。

    リンクhttps://{p}-{c}-daemon-1.{node}.computers.hoody.com

    AIに伝える内容
    スクレイパーを常に動かしておいてください。

    補足起動直後に失敗し続けるプログラムは、致命的な失敗として扱われ、再試行されなくなります。

    docs / kit / daemons

  • c28

    プログラムの権限を絞る

    プログラムごとに、書き込み、接続、使用できる範囲を制限します。

    リンクhttps://{p}-{c}-daemon-1.{node}.computers.hoody.com

    AIに伝える内容
    そのワーカーを、TCPポート443と53だけ開けて実行してください。

    補足デーモンのプログラム向けです。制限するのはTCPポートで、ホストではありません。一部のUnixソケットには引き続き接続でき、読み取り専用のルートが防ぐのは書き込みで、読み取りではありません。

    docs / kit / program-sandbox

  • c29

    DockerもKubernetesもすぐ使える

    DockerとComposeは開発用のKitに入っていて、すぐ使えます。Kubernetesは、少し設定すると内部で動かせます。

    AIに伝える内容
    テストスイートをDockerで実行してください。

    docs / foundation / computers / images

  • c30

    スケジュールタスク

    何でもスケジュールに沿って実行します。決めた時刻にジョブが自動で削除されるよう設定できます。

    リンクhttps://{p}-{c}-cron-1.{node}.computers.hoody.com

    AIに伝える内容
    毎晩3時にデータベースをバックアップしてください。

    docs / kit / cron

  • c31

    Webリクエストをリンクに

    どんなAPI呼び出しも、クリック、共有、スケジュール設定ができるリンクに変えられます。

    リンクhttps://{p}-{c}-curl-1.{node}.computers.hoody.com

    AIに伝える内容
    Webhookに送信するリンクを作ってください。

    補足リンクを知っている人なら誰でも、リンクに含まれるすべてのヘッダーと値を読めます。認証情報も含まれます。

    docs / kit / curl

  • c32

    繰り返し呼び出し、応答を保存

    スケジュールに沿ってAPIを呼び出し、応答をそれぞれファイルとして保存します。

    リンクhttps://{p}-{c}-curl-1.{node}.computers.hoody.com

    AIに伝える内容
    このAPIを1時間ごとに確認して、結果を保存してください。

    docs / kit / curl

  • c185

    起動時にプログラムを開始

    コンピューターが起動するたびに、プログラムを自動で開始します。

    リンクhttps://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/{id}/boot

    AIに伝える内容
    コンピューターの起動時に、APIサーバーを開始してください。

    補足有効なブートプログラムは、作成、有効化、編集した時点ですぐに起動することがあります。

    docs / kit / daemons

  • c186

    最初のリクエストで開始

    だれかが最初にポートへリクエストしたときに、サービスを開始します。

    リンクhttps://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/add

    AIに伝える内容
    アプリは、だれかが開いたときにだけ開始してください。

    補足lazy_loadとport_rangeが必要です。lazy_loadはboot: trueと併用できません。

    docs / kit / daemons

  • c187

    プログラムのログを読み取り

    プログラムの出力ログまたはエラーログの末尾を読み取るか、リアルタイムで追跡します。

    リンクhttps://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/{id}/logs

    AIに伝える内容
    ワーカーのエラーログの最後の200行を表示してください。

    補足ログは既定で5MiBごとにローテーションし、バックアップを2つ残します。どちらの設定も変更できます。

    docs / kit / daemons

  • c188

    一時的なコマンドを実行

    単発のプログラムを起動し、終了結果を受け取ります。

    リンクhttps://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/quick-start

    AIに伝える内容
    マイグレーションを1回実行し、終了コードを確認してください。

    補足起動待ちの時間内に終わらないコマンドは、runningを返します。終了後も10分間は、ステータスとログを参照できます。

    docs / kit / daemons

  • c189

    サーバーの準備完了を待機

    サーバーを起動し、ポートが接続を受け付けるようになってから応答を返します。

    リンクhttps://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/{id}/start

    AIに伝える内容
    APIポートの準備ができるまで待ってから、続行してください。

    補足プログラムにready_portを設定し、待機付きの起動を使います。

    docs / kit / daemons

  • c190

    ポートごとに1つのプログラム

    範囲を指定した複数のポートで、プログラムを別々のインスタンスとして実行します。

    リンクhttps://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/add

    AIに伝える内容
    ポート8000〜8003で、サービスを4つ実行してください。

    補足各インスタンスは、ポートをコマンドラインのフラグとして受け取ります。コマンドにはポートを含めないでください。

    docs / kit / daemons

  • c191

    対話型のデーモンプログラム

    管理下のプログラムを、ターミナルから見ながら入力できます。

    AIに伝える内容
    ワーカーをターミナルで実行し、対話できるようにしてください。

    補足サンドボックス化されたプログラムにterminal_idは指定できません。

    docs / kit / daemons

  • c192

    プログラムの状態一覧

    コマンドや環境変数を表示せずに、プログラムの状態を確認します。

    リンクhttps://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/overview

    AIに伝える内容
    プログラムの状態一覧を、安全な形で表示してください。

    docs / kit / daemons

  • c193

    オフラインのサンドボックスワーカー

    IPネットワークを切ってワーカーを実行します。インターネットには接続できません。

    リンクhttps://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/add

    AIに伝える内容
    このワーカーをIPネットワークなしで実行してください。

    補足パスで到達できるUnixソケットは、引き続き使えます。プログラムは、root以外で動く常駐のDaemonsプログラムである必要があります。

    docs / kit / program-sandbox

  • c194

    サンドボックスの接続レート

    サンドボックス内のサービスに、接続元ごとの接続レートを設定します。

    リンクhttps://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/edit/{id}

    AIに伝える内容
    アプリへの新規接続を、接続元ごとに毎秒50件までに制限してください。

    補足受信の対象は、新規のIPv4 TCP接続です。ルールが再構築されると、枠はリセットされます。送信元が65,535を超えた場合、新しい送信元は計測されません。

    docs / kit / program-sandbox

  • c195

    専用の一時領域

    サンドボックス内のプログラムに、空の一時ディレクトリを専用で用意します。

    リンクhttps://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/add

    AIに伝える内容
    このワーカーに、それぞれ256MiBまでの専用の一時領域を用意してください。

    補足プログラムは、root以外で動く常駐のDaemonsプログラムである必要があります。一時領域はメモリ上にあり、max_memoryに含まれます。

    docs / kit / program-sandbox / reference

スケジュールジョブのツール 7

  • c196

    スケジュールジョブをすぐに実行

    既存のスケジュールジョブをすぐに実行します。実行の受領確認が返ります。

    リンクhttps://{p}-{c}-cron-1.{node}.computers.hoody.com/api/v1/cron/users/{user}/entries/{id}/run

    AIに伝える内容
    スケジュールされたバックアップをすぐに実行してください。

    補足エントリーが存在し、有効である必要があります。一時停止中または期限切れのエントリーと、先に実行した「Run now」がまだ実行中のエントリーは、実行されません。

    docs / kit / cron

  • c197

    cronスケジュールの確認

    cronスケジュールを確認し、わかりやすい言葉で読み解きます。次の実行予定は最大3回分まで表示します。

    リンクhttps://{p}-{c}-cron-1.{node}.computers.hoody.com/api/v1/cron/schedule/describe

    AIに伝える内容
    このcron式を確認し、次の実行予定を表示してください。

    補足再起動時のみ、または一度も起動しないスケジュールでは、次回の実行時刻はnullです。

    docs / kit / cron

  • c198

    スケジュールジョブの一時停止

    スケジュールジョブを一時停止し、必要なときに再開します。

    リンクhttps://{p}-{c}-cron-1.{node}.computers.hoody.com/api/v1/cron/users/{user}/entries/{id}

    AIに伝える内容
    夜間のバックアップジョブをしばらく一時停止してください。

    補足一時停止したジョブは、crontabにコメントアウトされた行として残ります。

    docs / kit / cron

  • c199

    スケジュールジョブの履歴

    管理対象ジョブの状態、終了コード、実行時間を確認します。

    リンクhttps://{p}-{c}-cron-1.{node}.computers.hoody.com/api/v1/cron/runs

    AIに伝える内容
    夜間のバックアップは正常に終了しましたか?

    補足履歴に残る終了済みの実行は、エントリーごとに最大50件を30日間、全体では10,000件までです。生の行には実行履歴がありません。

    docs / kit / cron

  • c200

    スケジュールジョブのリアルタイムイベント

    ジョブの開始、終了、crontabの変更を、起きたとおりに追跡します。

    リンクhttps://{p}-{c}-cron-1.{node}.computers.hoody.com/api/v1/cron/events/sse

    AIに伝える内容
    スケジュールジョブの変更と実行を監視してください。

    補足ジョブの開始と終了を報告するのは、管理対象のエントリーだけです。直接書いた生のcrontab行は報告しません。

    docs / kit / cron

  • c201

    全ユーザーのジョブの監査

    コンピューターの全ユーザーについて、管理対象ジョブと、手書きジョブを解析した結果を一覧表示します。

    リンクhttps://{p}-{c}-cron-1.{node}.computers.hoody.com/api/v1/cron/entries

    AIに伝える内容
    全ユーザーのスケジュールジョブを一覧表示してください。

    補足すべてのページを取得し、unreadable_usersとjob_linesを確認してから、監査が完了したものとして扱ってください。

    docs / kit / cron

  • c202

    crontabを直接編集

    選んだユーザーのcrontab全体を読み取り、置き換えます。

    リンクhttps://{p}-{c}-cron-1.{node}.computers.hoody.com/api/v1/cron/users/{user}/crontab

    AIに伝える内容
    ワーカーアカウントのcrontabをそのまま表示してください。

    補足crontabを置き換えると、管理対象のエントリーも含めてすべて上書きされます。256KiB(262,144バイト)を超えるボディは受け付けません。

    docs / kit / cron

バックグラウンドのWebリクエスト 5

  • c203

    バックグラウンドのWebリクエスト

    時間のかかるWebリクエストをバックグラウンドで実行し、結果を後で受け取ります。

    リンクhttps://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request

    AIに伝える内容
    この時間のかかるAPIリクエストを開始し、結果は後で渡してください。

    補足終了したジョブの記録は、既定で7日後に削除されます。

    docs / kit / curl

  • c204

    失敗したリクエストの再試行

    失敗したWeb転送を、間隔を空けて再試行します。

    リンクhttps://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request

    AIに伝える内容
    転送に失敗したら、このダウンロードを再試行してください。

    補足リトライは最大5回です。リトライでは、POSTのボディが再送されます。

    docs / kit / curl

  • c205

    Cookieセッション

    名前付きセッションで、サイトへのリクエスト間でCookieを保持します。

    リンクhttps://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request

    AIに伝える内容
    ログインし、そのセッションでアカウントのデータを取得してください。

    補足セッションは削除されるまで保持されます。30日間使われない場合も削除されます。その後は同じIDでもCookieのないセッションが始まります。

    docs / kit / curl

  • c206

    APIイベントのストリーミング

    AIチャットのストリームなど、APIのライブイベントストリームを届いた順に取得します。

    リンクhttps://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request

    AIに伝える内容
    このAPIのイベントを、届いた順にストリーミングしてください。

    補足アップストリームのレスポンスは、ボディを持つ2xxで、Content-Typeがtext/event-streamである必要があります。各ストリームは既定で30分までです。

    docs / kit / curl

  • c207

    ジョブイベントの取得

    バックグラウンドリクエストの開始、進行、完了をイベントで追跡します。

    リンクhttps://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/sse

    AIに伝える内容
    バックグラウンドのダウンロードが終わったら知らせてください。

    docs / kit / curl

デバイスとネットワークをつなぐ 11

  • c33

    何でもリアルタイムで送信

    ファイル、画面、カメラ、データを、あるデバイスから別のデバイスへストリーミングします。

    リンクhttps://{p}-{c}-pipe-1.{node}.computers.hoody.com/api/v1/pipe/<name>

    AIに伝える内容
    このファイルをスマートフォンに送ってください。

    補足何も保存されません。送信側と受信側の両方が接続する必要があり、先に接続した側は初期設定で最大5分待ちます。ライブ配信のリンクを共有する前に、送信側のキーを設定してください。

    docs / kit / pipe

  • c34

    デスクトップ通知

    どのスクリプトからでも、コンピューターのデスクトップに通知を表示できます。スマートフォンにもアラートとして届きます。

    リンクhttps://{p}-{c}-n-1.{node}.computers.hoody.com

    AIに伝える内容
    ビルドが終わったら、スマートフォンに通知してください。

    補足通知は、デバイスごとにブラウザーで1回オンにします。配信はベストエフォートです。iPhoneでは、先にページをホーム画面に追加してください。

    docs / kit / notifications

  • c35

    ノートパソコンをオンラインにする

    コンピューターの該当ポートのリンクを使って、ノートパソコン上のサーバーを公開します。

    リンクhttps://{p}-{c}-http-3000.{node}.computers.hoody.com

    AIに伝える内容
    ローカルのポート3000をオンラインにしてください。

    補足プロキシの権限を設定するまでは、ポートのリンクを知っている人なら誰でも開けます。訪問者はポート専用のリンクを使います。トンネルのリンクは、トンネルの管理にだけ使います。

    docs / kit / tunnel

  • c36

    ノートパソコンに接続

    ノートパソコンが接続されている間、コンピューターからノートパソコン上のデータベースやサービスに接続できます。

    リンクhttps://{p}-{c}-tunnel-1.{node}.computers.hoody.com

    AIに伝える内容
    Hoodyのアプリが、ノートパソコン上のデータベースを使えるようにしてください。

    docs / kit / tunnel

  • c37

    通信の出口を選ぶ

    アプリをコンピューターのプロキシリンクに向けると、リクエストは選んだプロキシ、または自分のマシンを経由して外に出ます。

    リンクhttps://{p}-{c}-egress.{node}.computers.hoody.com

    AIに伝える内容
    スクレイパーを自分のプロキシ経由にしてください。

    補足プロキシの権限を設定するまでは、リンクを知っている人なら誰でも開けます。

    docs / kit / egress

  • c208

    コンピューターの通信経路の指定

    コンピューターの外向きTCP通信を、SOCKS5、HTTP、HTTPSプロキシ経由にします。

    リンクhttps://api.hoody.com/api/v1/computers/{id}/network

    AIに伝える内容
    このコンピューターの通信を、SOCKS5プロキシ経由にしてください。

    補足ルートの実行中に通るのはTCPだけです。DNSはプラットフォームのリゾルバーに送られ、そのほかの外向きのUDPとICMPはブロックされます。

    docs / foundation / networking / network

  • c209

    切れたトンネルの再接続

    接続が切れたあとトンネルを再開し、ポートも維持します。

    AIに伝える内容
    ネットワークが一時的に切れても、トンネルを使い続けられるようにしてください。

    補足リスナーは既定で60秒間、起動したままです。ドロップの間、開いている接続は切断されます。

    docs / kit / tunnel

  • c210

    ローカルハンドラーの公開

    別のサーバーを起動せずに、ノートパソコンのリクエストハンドラーを公開します。

    AIに伝える内容
    このローカルのリクエストハンドラーを、コンピューター経由で公開してください。

    補足serveヘルパーにはBunが必要です。Nodeでは、独自のHTTPサーバーとexposeを使います。

    docs / kit / tunnel

  • c211

    トンネルのバインドの確認

    有効なトンネルセッションと、バインドしているポートを確認します。

    リンクhttps://{p}-{c}-tunnel-1.{node}.computers.hoody.com/api/v1/tunnel/tunnels

    AIに伝える内容
    トンネルセッションとそのバインドを表示してください。

    docs / kit / tunnel

  • c212

    一時的なプロキシ出口

    クライアントが更新しない限り自動で無効になる、上流プロキシを設定します。

    リンクhttps://{p}-{c}-egress-1.{node}.computers.hoody.com/api/v1/egress/upstream?lease={seconds}

    AIに伝える内容
    クライアントが更新し続けている間だけ、このプロキシを使ってください。

    補足リースは5〜3,600秒です。既存のHTTPSトンネルは、閉じるまで元の出口を使い続けます。

    docs / kit / egress

  • c213

    別々のプロキシ認証情報

    外向きプロキシに、クライアントごとの認証情報を用意します。

    リンクhttps://{p}-{c}-egress-1.{node}.computers.hoody.com

    AIに伝える内容
    クライアントごとに、専用のプロキシ認証情報を用意してください。

    補足外向き通信のインデックスは、1つのアップストリームを共有します。プロキシの権限は、インデックスごとに設定する必要があります。

    docs / kit / egress

ライブ転送 6

  • c214

    ブラウザー転送ページ

    ブラウザーから、入力したテキスト、ファイル、貼り付けた画像を送信します。

    リンクhttps://{p}-{c}-pipe-1.{node}.computers.hoody.com/api/v1/pipe/

    AIに伝える内容
    貼り付けた画像を送れるブラウザーのページを開いてください。

    補足ブラウザー自体も、コンピューターのアクセスルールで許可されている必要があります。

    docs / kit / pipe

  • c215

    ライブ配信の視聴者

    ライブストリームを配信します。視聴者は自由に参加、退出できます。

    AIに伝える内容
    実行中に視聴者が参加できるよう、このログを配信してください。

    補足同時に最大256人の視聴者を受け付けます。視聴者が受け取るのは、参加した時点以降のストリームです。誰も見ていない間に送られたバイトは破棄されます。

    docs / kit / pipe

  • c216

    TCPポートの転送

    2台のマシン間のTCP接続を、パイプ経由で中継します。

    AIに伝える内容
    パイプ経由で、もう一方のマシンからデータベースに届くようにしてください。

    docs / kit / pipe

  • c217

    双方向パイプ

    2つのWebSocketピアを接続し、テキストとバイナリのメッセージをやり取りします。

    AIに伝える内容
    この2つのプログラムを連携させ、双方向で通信させてください。

    補足3つ目のピアには409が返ります。

    docs / kit / pipe

  • c218

    転送の進行状況

    受信枠を使わずに、転送の進行状況を確認します。

    リンクhttps://{p}-{c}-pipe-1.{node}.computers.hoody.com/api/v1/pipe/{name}?progress

    AIに伝える内容
    この転送の進行状況を表示してください。

    docs / kit / pipe

  • c219

    転送のチェックサム

    転送したバイト列を、サーバーが計算したSHA-256ダイジェストと照合します。

    AIに伝える内容
    このディスクイメージを送信し、チェックサムを検証してください。

    補足ハッシュ名または自分で名前を付けた転送では、受領記録を最大10分間保持します。

    docs / kit / pipe

アラートと通知 4

  • c220

    通知のライブフィード

    選んだディスプレイの通知を、ダッシュボードにストリーミングします。

    リンクhttps://{p}-{c}-n-1.{node}.computers.hoody.com/api/v1/notifications/stream

    AIに伝える内容
    ディスプレイ1の通知を、ダッシュボードにストリーミングしてください。

    補足ディスプレイのフィルタリングはルーティングであり、アクセス制御ではありません。ストリームのURLに到達できる人なら、すべてのディスプレイを要求できます。

    docs / kit / notifications

  • c221

    通知履歴

    1つまたは複数のディスプレイから、最近の通知を読み取ります。

    リンクhttps://{p}-{c}-n-1.{node}.computers.hoody.com/api/v1/notifications/{display}

    AIに伝える内容
    ディスプレイ1の最近の通知を表示してください。

    補足履歴には、閉じた通知と期限切れの通知は含まれません。履歴ファイルごとに、新しい1,000件を保持します。

    docs / kit / notifications

  • c222

    通知の緊急度の選択

    通知の緊急度と、表示される時間を設定します。

    リンクhttps://{p}-{c}-n-1.{node}.computers.hoody.com/api/v1/notifications/notify

    AIに伝える内容
    バックアップが失敗したら、緊急アラートを表示してください。

    補足有効期限は0〜300,000ミリ秒です。呼び出し元ごとに、1分間に10件の通知を送れます。

    docs / kit / notifications

  • c223

    アラート対象デバイスの管理

    登録済みのブラウザーを一覧表示し、アラートからデバイスを削除します。

    AIに伝える内容
    古いブラウザーを通知アラートから削除してください。

    補足既定の上限は、Kitごとにプッシュ購読50件です。

    docs / kit / notifications

ツールから丸ごとのコンピューターまで 16

  • c38

    ブラウザーでVS Code

    フル機能のVS Codeを、スマートフォンを含むどのブラウザーからでも使えます。

    リンクhttps://{p}-{c}-code-1.{node}.computers.hoody.com

    AIに伝える内容
    プロジェクトをVS Codeで開いてください。

    補足拡張機能はOpen VSXから入手します。それ以外は.vsixファイルとして追加できます。

    docs / kit / code

  • c39

    ファイルの変更を監視

    ファイルが変更されるたびに、リアルタイムのフィードを受け取れます。

    リンクhttps://{p}-{c}-watch-1.{node}.computers.hoody.com

    AIに伝える内容
    新しいアップロードがあったら知らせてください。

    補足ウォッチャーは、ウォッチサービスの再起動時に失われます。再起動後に作り直してください。

    docs / api / watch

  • c40

    アプリを探す

    多くのカタログからアプリを名前で探し、実行するコマンドを取得します。

    リンクhttps://{p}-{c}-run-1.{node}.computers.hoody.com

    AIに伝える内容
    Blenderを実行する方法を探してください。

    docs / api / run

  • c41

    通信ログ

    コンピューターに届いたすべてのリクエストを、リアルタイムでも後からでも確認できます。

    リンクhttps://{p}-{c}-logs-1.{node}.computers.hoody.com

    AIに伝える内容
    今日、サイトを開いたのは誰ですか?

    補足初期設定では、コンピューターごとに直近7日分を、最大50,000件または100MBまで保持します。

    docs / api / proxy-logs

  • c42

    ファイアウォール

    コンピューターに届く通信と、コンピューターが接続できる先を決められます。

    AIに伝える内容
    データベースのポートを、外部からの接続に対して閉じてください。

    補足指定できるのはIPv4アドレスと範囲のみで、ドメイン名は指定できません。HoodyのSSHゲートウェイ経由のSSHには、これらのルールは適用されません。

    docs / foundation / networking / firewall

  • c43

    Linuxソフトウェア

    必要なLinuxソフトウェアをインストールできます。コンピューターはHoodyのカーネルを共有するため、別のカーネルが必要な場合は仮想マシンを使います。

    AIに伝える内容
    Postgresをインストールし、アプリ用のデータベースを設定してください。

    docs / concepts / computers

  • c44

    完全な仮想マシン

    Windowsや別のLinuxを、コンピューター内で完全な仮想マシンとして実行します。

    リンクhttps://{p}-{c}-vm-1.{node}.computers.hoody.com

    AIに伝える内容
    Windows 11の仮想マシンを、コンピューターで起動してください。

    補足対象はレンタルまたは専有のサーバーのみです。コンピューターの停止中にKVMをオンにしておく必要があります。

    docs / kit / vm

  • c224

    失敗したリクエストの検索

    トラフィックログを、サービス、パス、HTTPステータス、リクエストIDで絞り込みます。

    リンクhttps://{p}-{c}-logs-1.{node}.computers.hoody.com/_logs

    AIに伝える内容
    今日のアプリへの失敗したリクエストを探してください。

    補足ログへのアクセスは、コンピューターのプロキシ権限と、設定した保持期間に従います。

    docs / api / proxy-logs

  • c225

    記録されたボディの読み取り

    コンピューターのトラフィックを調べるときに、保存されたリクエストボディまたはレスポンスボディを取得します。

    リンクhttps://{p}-{c}-logs-1.{node}.computers.hoody.com/_logs

    AIに伝える内容
    そのリクエストの、記録されたレスポンスボディを表示してください。

    補足シークレットらしい名前のフィールドは、保存前にマスクされます。1ページ内のボディが4MiBを超えると、残りはボディなしで返ります。

    docs / concepts / auditing

  • c226

    時間ごとのトラフィック集計

    条件に合うプロキシログのエントリを、時間区間ごとに集計します。

    リンクhttps://{p}-{c}-logs-1.{node}.computers.hoody.com/_logs/stats

    AIに伝える内容
    今日のアプリのエラー数を、1時間ごとに集計してください。

    補足バケットは1つあたり60,000ms以上で、ウィンドウごとに最大240個です。

    docs / api / proxy-logs

  • c227

    監視中のファイルの絞り込み

    選んだパスを監視し、イベントをファイル名のパターンや変更の種類で絞り込みます。

    リンクhttps://{p}-{c}-watch-1.{node}.computers.hoody.com/api/v1/watch/watchers

    AIに伝える内容
    アップロードフォルダーに新しいCSVファイルが入ったら検知してください。

    補足ウォッチャーは、サービスを再起動すると残りません。除外パターンは、含めるパターンより優先されます。

    docs / api / watch

  • c228

    ファイル変更の再取得

    イベントIDまたはタイムスタンプ以降に、ウォッチャーが保持したファイルイベントを取得します。

    リンクhttps://{p}-{c}-watch-1.{node}.computers.hoody.com/api/v1/watch/watchers/{id}/events

    AIに伝える内容
    今朝以降に保持されているファイル変更を表示してください。

    補足履歴はリングバッファのため、古いイベントは押し出されることがあります。ウォッチャーは、サービスを再起動すると残りません。

    docs / api / watch

  • c229

    待ち受けポートの検索

    待ち受け中のポートを一覧表示し、どのプログラムとユーザーが使っているかを確認します。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/system/ports

    AIに伝える内容
    ポート3000で待ち受けているプログラムを探してください。

    docs / api / terminal / monitoring

  • c230

    作業の一時停止と再開

    プロセスまたはプロセスツリーを一時停止し、メモリの状態を保ったまま再開します。

    AIに伝える内容
    ビルドを一時停止し、あとで再開してください。

    補足一部のシステムPIDとサービスPIDは保護されており、これらのエンドポイントからは凍結も再開もできません。

    docs / api / terminal / monitoring

  • c231

    サーバーのリソース使用状況

    サーバーのCPU、メモリ、ストレージの使用状況を確認します。

    リンクhttps://api.hoody.com/api/v1/rentals/{id}/runtime

    AIに伝える内容
    サーバーのCPUとメモリの使用状況を表示してください。

    補足ライブ呼び出しには、ログイン済みのセッションが必要です。サブサーバーと共有しているBare metalでは、409が返ります。

    docs / foundation / servers

  • c232

    ファイアウォールルールの一時停止

    ファイアウォールルールを1つずつ無効にし、必要なときに再度有効にします。

    リンクhttps://api.hoody.com/api/v1/computers/{id}/firewall/ingress

    AIに伝える内容
    この受信ファイアウォールルールを一時的に無効にしてください。

    補足HoodyのSSHゲートウェイを通るSSHは、これらのルールの影響を受けません。

    docs / foundation / networking / firewall

コードエディターのオプション 6

  • c233

    リンクでフォルダーを開く

    エディターを再起動せずに、リンクで任意のフォルダーを開きます。

    リンクhttps://{p}-{c}-code-1.{node}.computers.hoody.com/api/v1/code?folder={folder}

    AIに伝える内容
    プロジェクトのフォルダーをエディターで開いてください。

    補足正規化済みの絶対パスを送ってください。

    docs / api / code

  • c234

    チーム用の別々のエディター

    チームメンバーごとに、同じコンピューターのファイルを使う別々のエディターを用意します。

    AIに伝える内容
    同じプロジェクトのファイルで、それぞれ別のエディターを使えるようにしてください。

    補足エディターごとに設定と拡張機能は別です。共有カーソルは使えません。

    docs / guides / multiplayer

  • c235

    別々のエディターインスタンス

    設定と拡張機能が独立した、別々のエディターを開きます。

    リンクhttps://{p}-{c}-code-1.{node}.computers.hoody.com/

    AIに伝える内容
    クライアント案件用に、別のエディターを開いてください。

    補足インスタンスは、コンピューターのファイルとサービスアカウントを共有します。互いに信頼していない人には、別々のコンピューターを用意してください。

    docs / kit / code

  • c236

    すべてのエディター用の拡張機能

    URLから取得したVS Code拡張機能ファイルを、コンピューター上のすべてのエディターに追加します。

    リンクhttps://{p}-{c}-code-1.{node}.computers.hoody.com/api/v1/code/extensions/install

    AIに伝える内容
    このVSIX拡張機能を、エディター用に準備してください。

    補足拡張機能のインストールはエディターの起動時だけです。起動中のエディターは`restart=true`で再起動してください。

    docs / kit / code

  • c237

    拡張機能だけのエディター表示

    1つの拡張機能のサイドバービューに絞ったエディターのリンクを開きます。

    リンクhttps://{p}-{c}-code-1.{node}.computers.hoody.com/api/v1/code?folder={folder}&extension={extension}

    AIに伝える内容
    Python拡張機能のビューだけを開いてください。

    補足Codeが一致するサイドバービューを見つけられない場合は、代わりにExplorerを表示します。

    docs / kit / code

  • c238

    エディターの表示言語の選択

    インスタンスの起動時に、エディターの表示言語を選びます。

    リンクhttps://{p}-{c}-code-1.{node}.computers.hoody.com/api/v1/code?folder={folder}&locale={locale}

    AIに伝える内容
    エディターを日本語で開いてください。

    補足起動オプションは、インスタンスの起動時に反映されます。起動中のインスタンスには`restart=true`が必要です。

    docs / api / code

アプリの検索と実行 4

  • c239

    スターターアプリの一覧

    動作確認済みのスターターアプリを一覧し、それぞれの開き先を確認します。

    リンクhttps://{p}-{c}-run-1.{node}.computers.hoody.com/api/v1/run/catalog

    AIに伝える内容
    コンピューターのスターターアプリを表示してください。

    docs / api / run / resolve

  • c240

    アプリ起動の事前チェック

    アプリを実行する前に、実行計画と不足している要件を確認します。

    リンクhttps://{p}-{c}-run-1.{node}.computers.hoody.com/api/v1/run/preflight

    AIに伝える内容
    このアプリの実行に必要なものを確認してください。

    docs / api / run / resolve

  • c241

    アプリレシピの保存

    アプリの選び方と実行方法を名前付きレシピとして保存し、名前で再利用します。

    リンクhttps://{p}-{c}-run-1.{node}.computers.hoody.com/api/v1/run/recipes

    AIに伝える内容
    いつも使うFirefoxの選択を、レシピとして保存してください。

    docs / api / run / recipes

  • c242

    アプリのまとめて検索

    複数のアプリの検索や、コマンドの解決を、1回のリクエストでまとめて行います。

    リンクhttps://{p}-{c}-run-1.{node}.computers.hoody.com/api/v1/run/batch

    AIに伝える内容
    この10個のアプリの起動コマンドを探してください。

    補足1リクエストに含められる項目は最大100件です。これを超えるリクエストは、全体が400 `BATCH_TOO_LARGE`で拒否されます。

    docs / api / run / resolve

仮想マシン 14

  • c243

    ブラウザーでVM画面

    仮想マシンの画面を開き、キー入力とクリックを送ります。

    リンクhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/display

    AIに伝える内容
    VMの画面を開いてください。Linuxのインストールを終わらせたいです。

    補足VMには、専用に設定したディスプレイが必要です。ブラウザーでのコピー&ペーストには対応していません。ディスプレイには、独自のプロキシ権限があります。

    docs / kit / vm

  • c244

    VMのスナップショット

    リスクのある変更の前に停止中のVMのスナップショットを作成し、変更後に復元します。

    リンクhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/snapshots

    AIに伝える内容
    OSをアップグレードする前に、VMのスナップショットを作成してください。

    補足VMを停止しておく必要があります。復元すると、ディスク、UEFI varstore、TPMの状態が置き換えられ、元に戻せません。

    docs / kit / vm

  • c245

    VMインストーラーのダウンロード

    URLを指定して、仮想マシン用のインストーラーイメージをダウンロードします。

    リンクhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/isos/downloads

    AIに伝える内容
    このLinuxインストーラーをVM用にダウンロードしてください。

    補足ベンダーのSHA-256がある場合は指定してください。指定しない場合、イメージは初回使用時に信頼されます。

    docs / kit / vm

  • c246

    仮想マシンの一時停止

    VMのCPUを止め、メモリの内容を保ったまま再開します。

    リンクhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/pause

    AIに伝える内容
    次に使うまで、テスト用のVMを一時停止してください。

    補足一時停止したVMはメモリを保持したままです。メモリを解放するには、VMを停止します。

    docs / kit / vm

  • c247

    VMのポート転送

    コンピューターのポートを、仮想マシン内のサービスに転送します。

    リンクhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms

    AIに伝える内容
    ポート2222をVM内のSSHに転送してください。

    補足フォワードは、コンピューターのすべてのアドレスでホストポートを開きます。フォワードを変更するには、VMを停止します。

    docs / kit / vm

  • c248

    VMの共有フォルダー

    コンピューターと仮想マシンの間でフォルダーを共有します。

    リンクhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms

    AIに伝える内容
    プロジェクトのファイル用に、VMに共有フォルダーを追加してください。

    補足VMスナップショットのエクスポートには、共有フォルダーのファイルは含まれません。

    docs / kit / vm

  • c249

    VMディスクのクローン

    ほかのVMのディスクをコピーして、仮想マシンを作成します。

    リンクhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms

    AIに伝える内容
    アップグレードを試したいので、テスト用のVMをクローンしてください。

    補足コピー元のVMを停止しておく必要があります。コピーには、新しいIDとTPMが割り当てられます。

    docs / kit / vm

  • c250

    仮想マシンの移動

    VMのスナップショットをエクスポートし、別のコンピューターでVMを作成します。

    AIに伝える内容
    テスト用のVMを別のコンピューターに移してください。

    補足共有フォルダーのファイルは含まれません。元のディスクバスを使い、移行先を確認してから元を削除してください。

    docs / kit / vm

  • c251

    VMのサイズ変更

    停止中のVMのメモリ、CPU、ディスクサイズを、次回の起動に向けて変更します。

    リンクhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}

    AIに伝える内容
    停止中のVMのメモリとCPUを増やしてください。

    補足VMを停止しておく必要があります。ディスクサイズは増やすことしかできず、単独で送信する必要があります。

    docs / kit / vm / reference

  • c252

    VMの自動起動

    コンピューターの再起動後に、VMを自動で起動します。

    リンクhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}

    AIに伝える内容
    コンピューターの再起動後に、VMを自動で起動してください。

    補足自動起動は既定でオフです。変更するには、VMを停止しておく必要があります。

    docs / kit / vm

  • c253

    VMのシリアルコンソール

    VMのシリアルコンソールを読み取り、リンク経由でコマンドを送ります。

    リンクhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/console

    AIに伝える内容
    VMの起動に失敗したときのコンソール出力を読んでください。

    補足ゲストコンソールの多くはrootシェルです。書き込みアクセスは、シェルアクセスと同じものとして扱ってください。

    docs / kit / vm

  • c254

    入れ子の仮想マシン

    テストやCI用に、VMの中でハードウェアアクセラレーション対応の仮想マシンを実行します。

    AIに伝える内容
    ゲストの中にVMベースのCIを設定してください。

    補足ネストされた仮想化を有効にした専用サーバーが必要です。有効化は、Hoodyサポートへの依頼で行います。

    docs / foundation / servers / virtual-machines

  • c255

    VMゲストのインベントリ

    VMゲストのOS、ネットワークアドレス、ログイン中のユーザーを読み取ります。

    リンクhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/agent/inventory

    AIに伝える内容
    VM内のIPアドレスを表示してください。

    補足ゲストエージェントが情報を報告する必要があります。非対応または取得できない項目は、含まれない場合があります。

    docs / api / vm / console

  • c256

    VMのライブイベント

    VMの状態とスナップショットのイベントを、発生と同時にストリーミングします。

    リンクhttps://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/events

    AIに伝える内容
    VMの状態とスナップショットの変化を監視してください。

    補足切断後にイベントは再送されません。再接続して、現在の状態を読み取ってください。

    docs / kit / vm

標準で内蔵 10

  • c45

    共有ノート

    表、ファイル、コメントを含むノートを書き、リアルタイムで共同編集できます。

    リンクhttps://{p}-{c}-notes-1.{node}.computers.hoody.com

    AIに伝える内容
    今日の予定を共有ノートにまとめてください。

    docs / api / notes

  • c46

    いつものSSH

    使い慣れたSSH、SFTP、VS Code Remoteで接続できます。

    入力ssh root@{p}-{c}-ssh.{node}.computers.hoody.com

    AIに伝える内容
    コンピューターへのSSHコマンドを教えてください。

    補足登録できるのは公開鍵のみで、コンピューターごとに1つです。

    docs / foundation / networking / ssh

  • c47

    アップロード、検索、ZIP

    ファイルのアップロードと検索、アーカイブの展開、フォルダーのZIPダウンロードができます。

    リンクhttps://{p}-{c}-files-1.{node}.computers.hoody.com

    AIに伝える内容
    reportsフォルダーをZIPにして、ダウンロードリンクを送ってください。

    補足ZIPには、保護されたサービスの状態は含まれません。ファイルは最大1,000,000個まで入ります。

    docs / kit / files

  • c48

    実行中のものを確認

    CPU、メモリ、ディスクの動きをひと目で確認でき、実行中のプログラムも一覧できます。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/system/resources プログラムには/api/v1/system/processesを使います。

    AIに伝える内容
    コンピューターが今、遅いのはなぜですか?

    docs / kit / terminals

  • c49

    残る設定

    設定やキーを環境変数として保存します。再起動しても残ります。

    リンクhttps://api.hoody.com/api/v1/computers/{c}/env

    AIに伝える内容
    アプリのAPIキーを環境変数に設定してください。

    補足実行中のプログラムに変更が反映されるのは、再起動のあとです。コンピューター内でコマンドを実行できる人は、誰でも読み取れます。

    docs / api / computer-env

  • c50

    メモリ並みに速いストレージ

    キャッシュや一時的な作業向けに、メモリ上の高速ストレージを使えます。

    AIに伝える内容
    ビルドキャッシュをRAMストレージに置いてください。

    補足初期設定は512MiBで、上限はサーバーのメモリの半分です。サーバー上のすべてのコンピューターで共有され、サーバーの再起動時に消去されます。

    docs / foundation / storage / ramdisk

  • c52

    コンピューター内のVPN

    VPNプロバイダーのWireGuardファイルをコンピューター内で実行しても、リンクは引き続き使えます。

    AIに伝える内容
    このコンピューターをMullvad VPNに接続してください。

    補足WireGuardファイルは、プロバイダーのアプリではなくwg-quickで起動します。IPv6のエントリを削除し、Network Configurationのルートは停止したままにして、先にSSHキーを追加してください。

    docs / foundation / networking / vpn

  • c53

    デスクトップを録画

    デスクトップでの操作を、ビューアーからそのまま動画ファイルとして録画できます。

    リンクhttps://{p}-{c}-display-1.{node}.computers.hoody.com/?record=true

    AIに伝える内容
    AIがデモを実行している間、デスクトップを録画してください。

    補足ブラウザーが録画し、MP4、WebM、GIFのいずれかで保存します。GIFは30秒で止まります。長い録画は、保存するまでブラウザーのメモリに残ることがあります。

    docs / kit / displays

  • c54

    ターミナルにファイルをドロップ

    ドラッグして入れたかのように、ターミナル内のプログラムにファイルを渡せます。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/drop

    AIに伝える内容
    このスクリーンショットを、Claude Codeのターミナルにドロップしてください。

    docs / api / terminal / file-drop

  • c257

    シークレットをディスクに残さない

    復号したキーはメモリだけに置き、ディスク、スナップショット、バックアップには書き込みません。

    AIに伝える内容
    この作業の間、復号した認証情報をメモリに保持してください。

    補足Freeのサーバーと、有料のサブサーバーだけが対象です。ホストサーバーが再起動すると失われます。

    docs / foundation / storage / ramdisk

ノートの操作 8

  • c258

    ノートをMarkdownで読む

    ノートの1ページを、全体または行範囲を指定して、MarkdownまたはHTMLで取得します。

    リンクhttps://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/nodes/{nodeId}/document

    AIに伝える内容
    会議ノートのページをMarkdownで読んでください。

    補足返すのは1ページだけです。サブページを含むページには、ノートブックのエクスポートを使います。

    docs / api / notes / nodes

  • c259

    最近のノートを探す

    タイトルや本文が最近変わったノートブックのページを、新しい順に表示します。

    リンクhttps://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/recent

    AIに伝える内容
    最近変更されたページを表示してください。

    docs / api / notes / nodes

  • c260

    ノートにブロックを追加

    ノートの末尾に、テキストまたは構造化ブロックを追加します。

    リンクhttps://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/nodes/{nodeId}/document/append

    AIに伝える内容
    今日の会議ノートを、そのページの末尾に追加してください。

    補足1リクエストにつき最大100ブロックです。

    docs / api / notes / nodes

  • c261

    ノートの保存バージョン

    ノートを保存バージョンとして残し、あとで復元します。

    リンクhttps://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/nodes/{nodeId}/versions

    AIに伝える内容
    編集する前に、このノートの保存バージョンを作成してください。

    補足復元すると、置き換えられる内容が新しいバージョンとして保存されます。

    docs / api / notes / versions

  • c262

    ノートをZIPでエクスポート

    ノートブック全体、または1つのセクション、フォルダー、ページ、データベースを、MarkdownまたはHTMLのZIPでダウンロードします。

    リンクhttps://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/export

    AIに伝える内容
    ノートブックをMarkdownのZIPでエクスポートしてください。

    補足アーカイブに含まれるのは、読み取り権限のある項目だけです。チャンネルとメッセージ、データベースのビュー、フィールド定義は除外されます。

    docs / api / notes / notebooks

  • c263

    ノートの共同編集者の役割

    ノートに共同編集者を追加し、役割を選びます。

    リンクhttps://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/nodes/{nodeId}/collaborators

    AIに伝える内容
    Samをこのノートの共同編集者に追加してください。

    補足ロールは、admin、editor、collaborator、viewerのいずれかです。ページのadmin権限が必要です。

    docs / api / notes / collaborators

  • c264

    ノートのレコードを絞り込む

    ノートのデータベースにあるレコードを、絞り込み、並べ替え、名前で検索します。

    リンクhttps://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/databases/{databaseId}/records

    AIに伝える内容
    ノートのデータベースのレコードを、名前順で表示してください。

    補足一覧はページ分割されます。

    docs / api / notes / databases

  • c265

    再開できるノートのアップロード

    ファイルを分割してノートブックにアップロードします。中断しても再開できます。

    AIに伝える内容
    この大きな添付ファイルを、分割してノートブックにアップロードしてください。

    補足ファイルノードにアップロードできるのは、そのノードを作成したユーザーだけです。

    docs / api / notes / files

hoody / capabilities / bots

02 114 項目

Bots

日常の言葉でHoody全体を操作できます。Botがタスクをエージェントのチームに渡します。

Bot 17

  • b01

    Bot

    使い続けられる1つのチャットで、Hoody全体をふだんの言葉で操作します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{bot}?realm={realm}

    AIに伝える内容
    Botにブログの用意を頼んでください。

    docs / api / agent / bots

  • b02

    エージェントチーム

    どんなタスクでも任せると、エージェントのチームが実行し、結果を報告します。

    AIに伝える内容
    エージェントのチームで、失敗しているテストを直し、結果を報告してください。

    docs / api / agent / bots

  • b03

    説明し直し不要

    Botはメッセージをまたいで会話を保持します。長い会話は要約されることがあります。

    AIに伝える内容
    昨日の続きから始めてください。

    docs / api / agent / bots

  • b04

    ルールと範囲

    操作してよいコンピューターと、守るべきルールを選びます。

    AIに伝える内容
    Botの作業はWebプロジェクトだけに限り、mainにはpushしないでください。

    補足変更が反映されるのは、新たに委任されるエージェントのみです。すでに動いているエージェントは、渡された上限のまま動作します。

    docs / api / agent / bots

  • b05

    Botを共有

    Botの.hoody.botリンクを、信頼できる人と共有します。相手は、自分のキーを使ってどのブラウザーからでもチャットでき、アカウントは不要です。

    リンクhttps://<label>.hoody.bot

    AIに伝える内容
    共同創業者にBotへのアクセスを付与してください。

    補足全員が1つの会話を共有し、すべての呼び出しにクレジットかプロバイダーのキーが使われます。キーごとに、一時停止、無効化、アドレスによる制限ができます。リクエストの上限はすべてのキーに同じように適用されます。支出の上限はまだ設定できません。Bot URLはIPv4でのみ動作します。

    docs / kit / agent / bot-urls

  • b06

    ほかのAIアプリでBotを使う

    Botの.hoody.bot URLと名前付きのキーで、ほかのAIアプリやエージェントを連携します。

    リンクhttps://<label>.hoody.bot/v1

    AIに伝える内容
    このアプリのモデルにHoodyのBotを使ってください。

    補足Botは、共有される自分の会話を保持します。使われるのはアプリの最後のメッセージだけで、システムプロンプト、ツール、それ以前のメッセージは無視されます。

    docs / kit / agent / bot-urls / calling

  • b07

    Botと話す

    Botにリアルタイムで話しかけるか、録音した音声を送ります。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{bot}/voice

    AIに伝える内容
    運転中にBotと話せるようにしてください。

    補足音声接続は、Botごとに同時に1つまでです。音声には1日あたりの上限があります。

    docs / kit / agent / voice

  • b08

    音声アプリでBotを使う

    LiveKitやPipecatなど、OpenAI Realtimeで作られた音声アプリからBotと話せます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{bot}/realtime

    AIに伝える内容
    音声アシスタントをBotと連携してください。

    補足音声接続は、Botごとに同時に1つまでです。

    docs / api / agent / bots / voice

  • b10

    すべてのチャットアプリで同じBot

    Telegram、Slack、Discordのどれからでも、同じBotと同じ会話につながります。

    AIに伝える内容
    チームのSlackにもBotを接続してください。

    補足Botが読み取るのはテキストだけです。ファイル、画像、音声メッセージは渡されず、キャプションまたはテキストだけが渡されます。ペアリングした人は全員、同じ会話を共有します。

    docs / kit / agent / chat-apps

  • b29

    Botごとのモデル

    Bot自身の返信に使うモデルを選びます。

    AIに伝える内容
    調査用のBotに、専用のモデルを設定してください。

    補足Botが起動するタスクは、そのBotでタスクごとのモデルを有効にしない限り、デフォルトのモデルを使います。

    docs / kit / agent / ai-models

  • b30

    Bot用の独立したデフォルト設定

    AIアシスタントとは別に、Bot用のデフォルトモデルを設定します。

    AIに伝える内容
    Botのデフォルトモデルを、別のモデルにしてください。

    補足デフォルトに従うBotは、会話が再開されると新しいデフォルトに切り替わります。

    docs / kit / agent / ai-models

  • b31

    ハンズフリー音声

    ハンズフリーで話しかけます。話し始めと話し終わりは、Botが検出します。

    AIに伝える内容
    Botとのハンズフリーの会話を始めてください。

    補足ヘッドフォンを使ってください。全二重では、話しかけると返答を中断できます。

    docs / kit / agent / voice

  • b32

    音声で話しかけ、テキストで返信

    音声で質問し、Botの回答は音声を再生せずに文字で読めます。

    AIに伝える内容
    Botには音声で話しかけ、返信は文字で読めるようにしてください。

    補足音声のテキスト変換は引き続き実行されます。Hoody Voiceはサーバーの音声制限に数えられ、ほかのプロバイダーでは課金されます。

    docs / kit / agent / voice

  • b33

    作業用エージェントを選ぶ

    Botが任せる作業に使えるエージェントを選びます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{id}

    AIに伝える内容
    このBotには、レビュー用のエージェントだけを使わせてください。

    補足リストが空の場合は、どのエージェントでも対象です。

    docs / api / agent / bots

  • b34

    ルールに照らしてタスクを確認

    新しいタスクを始める前に、Botがガードレールに照らして確認します。

    AIに伝える内容
    新しいタスクを、Botのガードレールに照らして確認してください。

    補足厳格モードのBotは、チェッカーが実行できない間、すべてのタスクを拒否します。

    docs / kit / agent / ai-models

  • b35

    作業用エージェントの自動承認

    Botが作業を任せたエージェントに、ツールの承認を自動で与えます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{id}

    AIに伝える内容
    このBotの作業用エージェントで、ツールの自動承認をオンにしてください。

    補足デフォルトではオフです。その場合、ワーカーは事前に確認せずに動きます。

    docs / api / agent / bots

  • b36

    音声の1日あたり上限

    Botが話す量と文字起こしする量に、1日あたりの上限を設定します。

    AIに伝える内容
    Botの音声に、1日あたりの上限を設定してください。

    補足デフォルトは、UTCの1日あたり、読み上げ200,000文字、文字起こし14,400秒です。

    docs / api / agent / bots

チャットアプリのBot 11

  • b37

    チャットアプリのユーザーをペアリング

    ペアリングコードを渡すと、その人がチャットアプリでBotと話せます。

    AIに伝える内容
    SamがBotと話すためのペアリングコードを作ってください。

    補足ダイレクトメッセージのポリシーをpairingに設定します。新しいコードは前のコードを置き換えます。

    docs / kit / agent / chat-apps

  • b38

    チャットでの更新通知

    Botの完了した作業、承認の依頼、エラーを、ホームチャットに送ります。

    AIに伝える内容
    Botの作業の更新を、ダイレクトメッセージに送ってください。

    補足ホームチャットは、チャットアプリのダイレクトメッセージ1件、または承認済みグループ1つです。

    docs / kit / agent / chat-apps

  • b39

    チャットから停止

    チャットのコマンドで、Botの作業を停止します。

    AIに伝える内容
    TelegramからBotを停止してください。

    補足送信者には制御権限が必要です。

    docs / kit / agent / chat-apps

  • b40

    チャットの権限を選ぶ

    ペアリングした人に、チャット、コマンドの実行、承認の判断を許可するかどうかを選びます。

    AIに伝える内容
    SamにはBotとのチャットを許可し、承認の判断は許可しないでください。

    補足オープンなゲストはチャットしかできません。

    docs / kit / agent / chat-apps / settings

  • b41

    グループチャットを承認

    メンバーがBotと話せるのは、グループを承認したあとです。

    AIに伝える内容
    プロジェクトのグループがBotと話せるよう、承認してください。

    補足承認済みグループのメンバー全員が、Botの回答を読めます。

    docs / kit / agent / chat-apps

  • b42

    チャットユーザーをブロック

    Botのすべてのチャットで、選んだユーザーからのメッセージを破棄します。

    AIに伝える内容
    このユーザーがBotにメッセージを送れないよう、ブロックしてください。

    補足チャットアプリのブロックユーザーリストには、プラットフォームのユーザーIDを最大200件まで登録できます。

    docs / kit / agent / chat-apps / settings

  • b43

    返信をチャットにミラーリング

    Botのほかのアクセス経路からの返信を、ホームチャットにも送ります。

    AIに伝える内容
    Botのアプリでの返信を、ホームチャットにもミラーリングしてください。

    補足この設定は、デフォルトではオフです。

    docs / kit / agent / chat-apps / settings

  • b44

    すべてのチャットアプリを一時停止

    Botに接続しているチャットアプリを、すべてまとめて一時停止します。

    AIに伝える内容
    Botのチャットアプリをすべて一時停止してください。

    補足チャットアプリごとに、有効・無効の設定を個別に保持します。

    docs / kit / agent / chat-apps / settings

  • b45

    返信の形式を選ぶ

    Botのチャット返信を、書式付きにするかプレーンテキストにするかを選びます。

    AIに伝える内容
    Botの返信をプレーンテキストで送ってください。

    docs / kit / agent / chat-apps / settings

  • b46

    チャットのメッセージ制限

    Botを使う人とチャットごとに、メッセージの頻度を設定します。

    AIに伝える内容
    1人あたり、Botへのメッセージを1分に10件までにしてください。

    補足デフォルトでは、1人あたり1分に10件までメッセージを送れます。0を指定すると制限しません。設定できる上限は600です。

    docs / kit / agent / chat-apps / settings

  • b47

    チャット通知の言語

    Botのチャットアプリの通知に使う言語を選びます。

    AIに伝える内容
    チャットアプリの通知をフランス語で表示してください。

    補足Bot自身の回答は翻訳されません。使える言語は、en、de、fr、es、pt、it、ja、zhです。

    docs / kit / agent / chat-apps / settings

Bot URLのキーと制限 6

  • b48

    キーでBotの状態を確認

    Botが作業中かどうかと、承認待ちの項目を確認します。

    AIに伝える内容
    Botが作業中か、承認待ちかを確認してください。

    補足Bot URLキーが必要です。

    docs / kit / agent / bot-urls / calling

  • b49

    Botイベントの追跡

    Botのライブイベントを追い、保存したカーソルから再開します。

    AIに伝える内容
    前回のカーソルの続きから、Botのライブイベントを追ってください。

    補足Bot URLキーが必要です。ストリームは、キー1つにつき同時に4つまで開けます。

    docs / kit / agent / bot-urls / calling

  • b50

    有効期限付きのBotキー

    一時的なアクセス向けに、Bot URLのキーへ有効期限を設定します。

    リンクhttps://api.hoody.com/api/v1/bot-urls/{id}/keys/{keyId}

    AIに伝える内容
    SamのBotキーが12月末に失効するようにしてください。

    docs / api / bot-urls

  • b51

    Bot URLのアクセスログ

    どの名前付きキーが、どのアドレスからBotを呼び出したかを確認します。

    AIに伝える内容
    Botのアクセスログに、見覚えのないアドレスがないか確認してください。

    補足ベストエフォートです。拒否の一部はログに行が残りません。ログには、発言内容もキー自体も記録されません。

    docs / kit / agent / bot-urls / status

  • b52

    Bot URLのトラフィック制限

    Bot URLとそのキーに、リクエスト数と同時実行数の上限を設定します。

    AIに伝える内容
    Bot URLの、キーごとのリクエスト上限を下げてください。

    補足キーごとの設定は、すべてのキーに適用されます。制限の対象はリクエスト数で、金額ではありません。

    docs / kit / agent / bot-urls / security

  • b53

    Botキーをすべて無効化

    Bot URLをオフにし、すべてのキーをまとめて無効化します。

    リンクhttps://api.hoody.com/api/v1/bot-urls/{id}/panic

    AIに伝える内容
    Bot URLをオフにして、すべてのキーを無効化してください。

    補足実行中の呼び出しは最後まで完了し、Botがすでに始めた作業は、停止しない限り続きます。

    docs / kit / agent / bot-urls / security

コンピューターの中のエージェント 22

  • b11

    すべてのコンピューターにHoody Agent

    コンピューター内にAIエージェントが常駐します。タブで開くか、SSHまたはCLIから使います。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com

    AIに伝える内容
    Hoody Agentを開いてください。

    docs / kit / agent

  • b12

    閉じても続くセッション

    タブを閉じてもAIは作業を続けます。続きはどのデバイスからでも再開できます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com

    AIに伝える内容
    席を外している間も、この作業を続けてください。

    docs / kit / agent

  • b13

    どのモデルでも

    100以上のAIプロバイダーから選べます。独自のモデルサーバーも追加できます。

    AIに伝える内容
    このチャットをより速いモデルに切り替えてください。

    補足独自のモデルサーバーは、公開HTTPSアドレスでOpenAIまたはAnthropicのAPIに対応している必要があります。

    docs / kit / agent

  • b14

    複数のモデルを同時に

    複数のモデルに同時に質問し、まとめた1つの回答を受け取ります。

    AIに伝える内容
    3つのモデルに質問し、最も良い回答を教えてください。

    docs / kit / agent / ai-models

  • b15

    GitHub内蔵

    エージェントから直接、クローン、コミット、プルリクエストの作成ができます。

    AIに伝える内容
    この修正でプルリクエストを作成してください。

    docs / kit / agent

  • b16

    AIにツールを追加

    MCPサーバーを接続して、エージェントに新しいツールを追加します。

    AIに伝える内容
    チームのMCPサーバーをエージェントに追加してください。

    補足ローカルサーバーは自分の権限で動作し、サンドボックスで隔離されません。リモートサーバーは、指定したヘッダーを受け取ります。信頼できるサーバーだけを追加してください。

    docs / kit / agent

  • b17

    どのAIでも使えるメモリ

    エージェントはメモリを保存して検索します。特定のAIアプリに縛られません。

    AIに伝える内容
    サイトがPostgresを使っていることを覚えておいてください。

    docs / api / agent / memory

  • b18

    スキル

    新しい仕事を覚えさせるスキルをインストールします。

    AIに伝える内容
    リリースノートを書くスキルをインストールしてください。

    docs / api / agent / skills

  • b19

    スケジュール実行のAI

    スケジュールに沿って、エージェントが状況を確認し、作業します。

    AIに伝える内容
    今日は1時間ごとにサイトを確認し、問題があれば知らせてください。

    補足1分以上の一定間隔で繰り返します。初期設定は50回までで、回数は変更できます。有効にできるループは最大8つです。チャットを閉じるか、エージェントを再起動すると停止します。継続するスケジュールには、cronを使ってください。

    docs / api / agent / loops

  • b20

    保存したAIワークフロー

    AIのワークフローを保存して、好きなときにもう一度実行できます。

    AIに伝える内容
    これを、もう一度実行できるワークフローとして保存してください。

    docs / api / agent / workflows

  • b21

    AIのやることリスト

    AIが予定しているタスクと、作業中のタスクを確認します。

    AIに伝える内容
    プロジェクトのやることリストには何がありますか?

    docs / api / agent / todos

  • b22

    チャットの分岐

    チャットを分岐して、別の方法を試せます。元のチャットはそのまま残ります。

    AIに伝える内容
    このチャットを分岐して、別のデザインで試してください。

    docs / api / agent / sessions

  • b23

    AIの使用量を確認

    チャットごと、モデルごとのAI使用量を確認します。

    AIに伝える内容
    今週のAI使用量はどれくらいですか?

    docs / api / agent / statistics

  • b24

    チャットなしのジョブ

    エージェントにジョブを送り、結果はあとで受け取れます。チャットは不要です。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com

    AIに伝える内容
    このレポートをバックグラウンドで実行し、あとで確認できるジョブを渡してください。

    補足ヘッドレスジョブは、確認をすべて自動で承認し、コンピューターでコマンドを実行できます。先に、プロキシの権限でエージェントのリンクをロックしてください。結果はジョブから取得します。

    docs / api / agent / headless

  • b25

    エージェントのイベントにフック

    エージェントの開始時、ツールの使用時、終了時に、自分のコマンドを実行します。Claude Code方式です。

    AIに伝える内容
    テストが通るまで、エージェントを終了させないでください。

    補足編集したフックは、OKを出すまで実行されません。

    docs / api / agent / hooks

  • b26

    独自のエージェント

    独自のエージェントを作成します。モデル、ツール、指示をエージェントごとに設定できます。

    AIに伝える内容
    安価なモデルを使う、読み取り専用のレビュアーエージェントを作ってください。

    docs / api / agent / agents

  • b27

    実行前に確認

    変更を伴う操作のたびに、エージェントが確認を求めるようにします。

    AIに伝える内容
    何かを変更または実行する前に、確認してください。

    補足読み取りは確認なしで通ります。確認を求められないサブエージェント、ワークフローの実行、その他の入れ子の実行は拒否されます。フックはスキップされ、MCPサーバーは起動しません。ロックしたモードは、セッション中はオンのままです。

    docs / api / agent / sessions / approvals

  • b28

    スマートフォンから承認

    Botのエージェントが危険な操作の前に確認を求めたら、Telegram、Slack、Discordで「承認」または「拒否」をタップします。

    AIに伝える内容
    何かをデプロイする前に、Telegramで確認を取ってください。

    補足ボタンを押せるのは、許可した人だけです。

    docs / kit / agent / chat-apps / approvals

  • b54

    作る前に計画する

    エージェントを計画モードに切り替え、実装の前に作業を設計します。

    AIに伝える内容
    アプリを作る前に、アーキテクチャを計画してください。

    補足計画をもとにビルドするには、汎用エージェントに戻します。

    docs / guides / vibe-coding

  • b55

    アプリのライブプレビュー

    エージェントがファイルを変更するたびに、アプリのプレビューが更新される様子を見られます。

    AIに伝える内容
    アプリを作る間、ライブプレビューを開始してください。

    補足ドキュメントのワークフローでは、Vite開発サーバーを起動し、コンピューターのディスプレイ上のブラウザーで開きます。

    docs / guides / vibe-coding

  • b56

    編集せずに調べる

    探索モードで、読み取り専用のツールを使ってコードを調べます。

    AIに伝える内容
    このコードベースを調べて、ログインの仕組みを説明してください。

    docs / guides / vibe-coding / reference

  • b57

    エージェントの作業をストリーミング

    ターンの実行中に、エージェントのツール呼び出し、結果、メッセージを確認します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{session_id}/prompt:stream

    AIに伝える内容
    エージェントの作業中のツール呼び出しを表示してください。

    補足プロキシの権限を設定していない場合は、コンピューターのURL自体が認証情報です。

    docs / guides / ai-agents

エージェントのセッション 14

  • b58

    チャットの名前を変更

    エージェントのセッションに、探しやすいタイトルを付けます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}

    AIに伝える内容
    このチャットの名前を「リリース計画」に変更してください。

    補足タイトルは120文字までです。

    docs / api / agent / sessions

  • b59

    チャットの履歴を読む

    保存した会話を、ツール呼び出しとその結果を含めて取得します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/transcript

    AIに伝える内容
    直前のセッションの履歴を表示してください。

    docs / api / agent / sessions / streaming

  • b60

    会話を途中までに戻す

    セッションから後のターンを削除し、前の時点から続けます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/trim

    AIに伝える内容
    このチャットを、直前のリクエストより前のターンまで戻してください。

    補足ターン間でのみ使えます。ターンの実行中は使えません。

    docs / api / agent / sessions

  • b61

    複数のセッションを監視

    実行中のセッション最大32件のイベントを、1つのストリームで追えます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions:events

    AIに伝える内容
    これらのエージェントセッションをまとめて監視してください。

    補足監視できるのは、ライブセッションだけです。

    docs / api / agent / sessions / streaming

  • b62

    推論の強度を調整

    セッションのモデルが使う推論の強度を選びます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/effort

    AIに伝える内容
    このセッションの推論の強度を「高」にしてください。

    補足レベルはlow、medium、high、xhigh、maxです。

    docs / api / agent / sessions / settings

  • b63

    エージェントの返信を短く

    返答の詳しさを、必要な情報量に合わせて設定します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/verbosity

    AIに伝える内容
    このセッションの返信を簡潔にしてください。

    docs / api / agent / sessions / settings

  • b64

    エージェントの保留中の質問

    各セッションで回答や確認を待っている質問をまとめて確認します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/gates

    AIに伝える内容
    入力が必要なエージェントセッションを表示してください。

    補足このエージェントがライブで保持しているセッションだけが一覧に表示されます。

    docs / api / agent / sessions / approvals

  • b65

    ツールを許可または拒否

    エージェントの特定のツールを許可または拒否するセッションルールを設定します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/approval/rules/{tool}

    AIに伝える内容
    現在のセッションでは、このツールを拒否してください。

    補足セッションのポリシーがロックされている場合、または操作のたびに確認する設定の場合、許可ルールは拒否されます。

    docs / api / agent / sessions / approvals

  • b66

    質問への回答案

    エージェントが保留している質問に対する、補助モデルの回答案を受け取ります。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/answer:assist

    AIに伝える内容
    エージェントが回答を待っている質問に、回答案を出してください。

    補足候補は質問への回答ではありません。実際の回答は別に送信されます。

    docs / api / agent / sessions / approvals

  • b67

    実行中のワークフローに指示を出す

    実行中のワークフローに、フィードバックを送ります。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/workflow/messages

    AIに伝える内容
    実行中のワークフローに、リリースノートに集中するよう伝えてください。

    補足ワークフローの実行中にのみ使います。ゲートが保留されている間に送ったメッセージは破棄されるため、ターンの終了後にもう一度送信してください。

    docs / api / agent / sessions / turns

  • b68

    ターンの結果を確認

    切断や再起動のあとに、ターンの状態と結果を確認します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/turns/{turn_id}

    AIに伝える内容
    直前のエージェントのターンが終了したか確認してください。

    補足ライブセッションと休止中のセッションの両方で使えます。

    docs / api / agent / sessions / turns

  • b69

    別のセッションを待つ

    別のセッションの作業で、指定した結果が出るまでセッションを待機させます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/waiters

    AIに伝える内容
    もう一方のセッションからビルド完了の報告があるまで待ってください。

    補足対象は、同じレルムにある別のライブセッションである必要があります。待機は、エージェントを再起動すると引き継がれません。

    docs / api / agent / sessions / waiters

  • b70

    要約後の指示

    エージェントが会話を圧縮するたびに、選んだ指示をもう一度渡します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/after-compaction

    AIに伝える内容
    会話を要約するたびに、テストを実行するようエージェントに思い出させてください。

    補足最大16KiBです。Claude Codeのセッションでは使えません。

    docs / api / agent / sessions / settings

  • b71

    エージェントの作業を一時停止

    エージェントのセッションを一時停止し、止まった地点から再開します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/pause

    AIに伝える内容
    続ける準備ができるまで、エージェントを一時停止してください。

    補足一時停止は、すべてのレルムのすべてのセッションに及びます。実行中の作業は先に完了し、独立したClaude Codeの作業の一部は保留されません。

    docs / api / agent / system

エージェントのメモリ 4

  • b72

    メモリをオフにする

    エージェントのメモリのプライバシースイッチを、オンまたはオフにします。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/memory/enabled

    AIに伝える内容
    このレルムのメモリをオフにしてください。

    docs / api / agent / memory

  • b73

    メモリを編集

    保存したメモリの記録を更新します。指定しなかった項目はそのまま残ります。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/memory/items/{id}

    AIに伝える内容
    保存したプロジェクトの設定を、TypeScriptを使う内容に更新してください。

    docs / api / agent / memory

  • b74

    保存したメモリを削除

    エージェントのメモリから、特定の記録を1件または複数削除します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/memory/items

    AIに伝える内容
    古くなったこれらのメモリの記録を削除してください。

    補足個々のレコードを削除しても、プロジェクトの要約、関係グラフ、統合処理の残りデータは消えません。

    docs / api / agent / memory

  • b75

    メモリの関係を表示

    プロジェクトのメモリグラフにあるノードと接続を調べます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/memory/graph

    AIに伝える内容
    このプロジェクトのメモリにある関係を表示してください。

    docs / api / agent / memory

バックグラウンド作業 9

  • b76

    ループをすぐに実行

    スケジュールしたエージェントループを、次の間隔を待たずにすぐ実行します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/loops/{loopId}/run-now

    AIに伝える内容
    スケジュールしたチェックをすぐに実行してください。

    補足一時停止中のループは1回だけ実行され、一時停止のままです。サーキットブレーカーで一時停止したループは、スケジュールを再開します。

    docs / api / agent / loops

  • b77

    ループの予算を設定

    繰り返し実行するエージェントループに、コストと時間の上限を設定します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/loops/{loopId}

    AIに伝える内容
    このループに、コストと時間の予算を設定してください。

    補足1回の更新で変更できるのは、一時停止の状態、有効期限、予算のいずれか1つです。0を指定すると上限を外します。

    docs / api / agent / loops

  • b78

    条件でループを停止

    繰り返し実行するエージェントループを、選んだ条件を満たしたときに停止するよう設定します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/loops

    AIに伝える内容
    停止条件を満たすまで、このチェックを繰り返してください。

    補足受け付ける間隔は最短60秒です。max_runsを省略する、0にする、または負の値にすると、デフォルトの上限である50回が適用されます。

    docs / api / agent / loops

  • b79

    ヘッドレス実行をストリーミング

    ヘッドレスのエージェント実行を、イベントのライブストリームとして受け取ります。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/headless/runs

    AIに伝える内容
    このタスクをヘッドレスで実行し、進捗をストリーミングしてください。

    補足ヘッドレス実行は、確認、計画、質問を自動で承認し、コードを実行できます。エージェントのURLはプロキシの権限で保護してください。

    docs / api / agent / headless

  • b80

    エージェントのジョブをキャンセル

    待機中または実行中の非同期エージェントジョブを停止します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/jobs/{id}

    AIに伝える内容
    そのエージェントジョブをキャンセルしてください。

    補足完了したジョブを削除すると、ジョブの履歴も削除されます。

    docs / api / agent / jobs

  • b81

    サブエージェントの履歴を読む

    バックグラウンドのサブエージェントが行ったタスクの履歴と要約を確認します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/tasks/{tid}/transcript

    AIに伝える内容
    バックグラウンドのレビュアーが行った作業を表示してください。

    docs / api / agent / tasks

  • b82

    サブエージェントのタスクをキャンセル

    セッションの作業中に、バックグラウンドのサブエージェントのタスクを1件停止します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/tasks/{tid}/cancel

    AIに伝える内容
    バックグラウンドの調査タスクをキャンセルしてください。

    補足セッションがライブである必要があります。

    docs / api / agent / tasks

  • b83

    バックグラウンドのシェルを確認して停止

    エージェントのセッションが起動したバックグラウンドのシェルを一覧表示し、1つ停止します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/bash-jobs

    AIに伝える内容
    このセッションが起動したバックグラウンドのシェルを表示してください。

    docs / api / agent / tasks

  • b84

    フックを一時停止

    エージェントのライフサイクルフックを、無効にしたり再び有効にしたりします。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/hooks/toggle

    AIに伝える内容
    lintフックをオフにしてください。

    補足ライブのエージェントセッションが必要です。

    docs / api / agent / hooks

スキル・ワークフロー・タスク 10

  • b85

    既存のスキルをインポート

    選んだClaudeまたはCodexのスキルを、エージェントのローカルスキルストアに取り込みます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/skills/import/apply

    AIに伝える内容
    既存のClaudeスキルをエージェントにインポートしてください。

    補足先にスキルをスキャンします。保存先がすでに存在する場合は、上書きを指定しない限り拒否されます。

    docs / api / agent / skills

  • b86

    スキルをプレビュー

    ハブのスキルを、コンピューターにインストールする前にプレビューします。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/skills/hub/preview

    AIに伝える内容
    インストールする前に、リリースノートのスキルをプレビューしてください。

    補足プレビューには、検索結果にあるプロバイダー、ソース、スキルIDが必要です。

    docs / api / agent / skills

  • b87

    スキルをオフにする

    名前を指定してスキルを無効にし、必要なときに再び有効にします。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/skills/toggle

    AIに伝える内容
    ウェブ検索のスキルをいったん無効にしてください。

    docs / api / agent / skills

  • b88

    スキルの指示を編集

    スキルのソースを読み込んで置き換え、エージェントが学ぶ内容を変更します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/skills/source

    AIに伝える内容
    リリースノートのスキルを、新しい形式に更新してください。

    docs / api / agent / skills

  • b89

    ワークフローを再開

    失敗した、またはキャンセルしたワークフローを、最初の未完了のステップから続けます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/workflows/runs/{run_id}/resume

    AIに伝える内容
    失敗したワークフローを、止まったところから再開してください。

    補足ライブセッションはアイドル状態で、実行のレルム、所有者、作業ディレクトリ、コンピューターと一致している必要があります。実行を再開できるのは1回だけです。

    docs / api / agent / workflows

  • b90

    ワークフローのステップを確認

    各ステップの状態、所要時間、AIトークンの使用量、エラーを確認します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/workflows/runs/{run_id}

    AIに伝える内容
    そのワークフローで失敗したステップを表示してください。

    補足実行は、保持されている間だけ利用できます。

    docs / api / agent / workflows

  • b91

    タスクを実行

    バックグラウンドのワーカーを起動し、タスクを自律的に進めさせます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/todos/{id}/run

    AIに伝える内容
    このタスクのワーカーを起動してください。

    補足リクエストは人による承認として扱われ、ワーカーはそれ以上の確認を求めません。完了したかどうかは、タスク自体で確認してください。

    docs / api / agent / todos

  • b92

    タスクを絞り込む

    エージェントの一覧から、状態、タグ、検索テキストでタスクを探します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/todos

    AIに伝える内容
    billingタグが付いた未完了のタスクを表示してください。

    docs / api / agent / todos

  • b93

    タスクをスヌーズ

    指定した時刻までタスクをスヌーズします。設定済みのスヌーズの解除もできます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/todos/{id}/snooze

    AIに伝える内容
    このタスクを明日までスヌーズしてください。

    docs / api / agent / todos

  • b94

    タスクにコメント

    エージェントのターンを新たに始めずに、タスクのタイムラインにコメントを追加します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/todos/{id}/messages

    AIに伝える内容
    この顧客の情報をタスクに追加してください。

    docs / api / agent / todos

エージェントからのGitHub操作 6

  • b95

    リポジトリの変更を確認

    リポジトリのステージ済みまたは未ステージの変更を、unified diff形式で読み取ります。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/diff

    AIに伝える内容
    リポジトリのステージ済みの変更を表示してください。

    補足取得した出力は1MiBまでです。

    docs / api / agent / github

  • b96

    コミットメッセージを下書き

    リポジトリの未コミットの変更から、モデルにコミットメッセージを下書きさせます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/commit/suggest-message

    AIに伝える内容
    変更内容に合うコミットメッセージを提案してください。

    補足差分はモデルのプロバイダーに送信され、呼び出しは課金されます。コミットはしません。

    docs / api / agent / github

  • b97

    GitHubのIssue

    エージェントから、リポジトリのIssueを一覧表示したり、新しいIssueを作成したりします。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/issues

    AIに伝える内容
    ログインページの不具合についてIssueを作成してください。

    補足Issueの一覧は最大200件で、更新が新しい順に返されます。

    docs / api / agent / github

  • b98

    リンク済みワークツリー

    リポジトリの別のブランチで作業するために、リンク済みワークツリーを作成します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/worktrees

    AIに伝える内容
    機能ブランチ用のワークツリーを作成してください。

    docs / api / agent / github

  • b99

    GitHubアカウントの切り替え

    エージェントが以降の操作で使う、連携済みのGitHubアカウントを切り替えます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/auth/active

    AIに伝える内容
    エージェントを仕事用のGitHubアカウントに切り替えてください。

    補足アカウントをあらかじめ連携しておく必要があります。

    docs / api / agent / github

  • b100

    リモートブランチを確認

    チェックアウトを変えずに、GitHubのブランチが指すコミットを確認します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/remote-branch

    AIに伝える内容
    直前のプッシュがリモートブランチに届いたか確認してください。

    補足アクティブなアカウントでGitHubを読み取ります。ローカルのチェックアウトは何も変更しません。

    docs / api / agent / github

エージェントの設定 15

  • b101

    AIの支出上限を設定

    チャットとターンごとの支出上限を設定します。上限に達すると、作業を止めるか警告します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/settings/spend-caps

    AIに伝える内容
    エージェントのチャットに支出上限を設定してください。

    補足上限は米ドル建てで、0(オフ)から1,000,000まで設定できます。実行中の作業が止められることはありません。

    docs / api / agent / settings

  • b102

    プロバイダーアカウントのローテーション

    プロバイダーのアカウントが上限に達すると、エージェントはログイン済みの別のアカウントに切り替えます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/settings/features

    AIに伝える内容
    エージェントのアカウントローテーションをオンにしてください。

    docs / api / agent / settings

  • b103

    MCP設定をインポート

    Claude、Cursor、VS CodeのMCPサーバー定義を、エージェントに取り込みます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/mcp/import

    AIに伝える内容
    CursorのMCPサーバー設定をインポートしてください。

    補足インポートしたサーバーは無効の状態で始まります。無効なエントリーが1つでもあると、インポート全体が中止されます。

    docs / api / agent / mcp

  • b104

    MCPサーバーをテスト

    サーバーの設定をテストし、保存する前にツールを確認します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/mcp/probe

    AIに伝える内容
    保存する前に、このMCPサーバーの設定をテストしてください。

    補足プローブは人だけが実行できます。プロセスを起動したり、外向きのリクエストを送ったりすることがあります。

    docs / api / agent / mcp

  • b105

    MCPサーバーを無効にする

    MCPサーバー1つをオフにします。保存した設定と認証情報は残ります。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/mcp/servers/enable

    AIに伝える内容
    課題管理ツールのMCPサーバーをいったん無効にしてください。

    補足無効にすると、すべてのライブセッションからサーバーがすぐに切り離されます。

    docs / api / agent / mcp

  • b106

    レルム全体の指示

    レルム(コンピューターのグループ)内のチャット、ヘルパー、ワークフローの各ステップで共有する指示を設定します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/settings/agent-instructions

    AIに伝える内容
    このレルムのすべてのエージェントに、アメリカ英語を使うよう伝えてください。

    補足実行中のチャットには、次のターンから変更が反映されます。

    docs / api / agent / settings

  • b107

    エージェントをコピー

    エージェントの定義を新しい名前でコピーして、独自のバリエーションを作ります。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/agents/{name}/copy

    AIに伝える内容
    レビュー用エージェントをコピーして、カスタマイズできるようにしてください。

    補足製品側が管理するBotエージェントと同じ名前には、コピーできません。

    docs / api / agent / agents

  • b108

    エージェントのターン数上限を設定

    エージェント1つが1回の実行で行うターン数の最大値を設定します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/agents/{name}/turns

    AIに伝える内容
    レビュー用エージェントのターン数上限を設定してください。

    補足Botエージェントは、この方法では変更できません。

    docs / api / agent / agents

  • b109

    エージェントを初期設定に戻す

    カスタマイズした標準エージェントを、元の定義に戻します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/agents/{name}/reset-to-shipped

    AIに伝える内容
    このエージェントを標準の初期状態に戻してください。

    補足リセットすると、ローカルのカスタマイズは破棄されます。

    docs / api / agent / agents

  • b110

    Claude設定をコピー

    コンピューター間で、Claude Codeの設定をプレビューしてコピーします。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/acp/agents/{agent}/file-syncs

    AIに伝える内容
    Claude Codeの設定を、ほかのコンピューターにコピーしてください。

    補足最大200ファイル、合計8MiB、1ファイルあたり2MiBまでです。認証情報のファイルと、ログインや会話を含む状態は対象外です。

    docs / api / agent / settings

  • b111

    プロバイダーキーをテスト

    保存済みのプロバイダーAPIキーが有効かどうかを、キーを表示せずに確認します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/providers/{id}/auth/test

    AIに伝える内容
    保存済みのプロバイダーキーをテストしてください。

    補足判定は、有効、無効、判定不能のいずれかです。キーはあらかじめ保存しておく必要があります。

    docs / api / agent / models

  • b112

    アカウント別の使用量

    AIの使用量を、プロバイダーとアカウント別にまとめて確認します。全期間、または指定した日以降を選べます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/usage/by-account

    AIに伝える内容
    月曜日からのAI使用量を、アカウント別に表示してください。

    補足使用量は全体の値で、レルムごとには区切られません。開始時刻を省略すると、全期間の使用量になります。

    docs / api / agent / statistics

  • b113

    エージェントのレルムを選択

    新しいセッションでエージェントが既定で使うレルムを選択します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/hoody/realm

    AIに伝える内容
    新しいエージェントセッションでは、仕事用のレルムを使ってください。

    補足選択はすべてのクライアントに適用されます。既存のセッションは、それぞれのレルムを保持します。レルムが限定されたログインでは、許可されたレルムだけを選べます。

    docs / api / agent / discovery

  • b114

    エージェントのログを検索

    エージェントのログを、セッション、時間、レベル、テキストで絞り込みます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/logs

    AIに伝える内容
    このエージェントセッションで、直近1時間のエラーを探してください。

    補足1ページあたり最大500件、デフォルトは200件です。

    docs / api / agent / logs

  • b115

    マスク済みログをエクスポート

    絞り込んだエージェントのログを、機密部分をマスクしたJSONLまたはテキストでダウンロードします。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/logs/export

    AIに伝える内容
    エージェントのエラーを、マスク済みのテキストファイルにエクスポートしてください。

    補足エクスポートでは、常に機密情報が伏せられます。プラットフォームを出所とするエクスポートは1ページ分で、デフォルトは2,000行です。

    docs / api / agent / logs

hoody / capabilities / api

03 64 項目

API

Hoodyでできることは、AIやスクリプトからも実行できます。

Hoodyで開発 13

  • a01

    すべてを1つのAPIで

    Hoodyでできることは、AIやスクリプトからも実行できます。

    リンクhttps://api.hoody.com

    AIに伝える内容
    Hoody APIでこれをセットアップしてください。

    docs / foundation / hoody-api

  • a02

    必要なときにコンピューター

    AIがプロジェクトにコンピューターを作成し、起動、停止、削除します。

    入力POST https://api.hoody.com/api/v1/projects/{p}/computers

    AIに伝える内容
    このクライアントのプロジェクトにコンピューターを追加してください。

    docs / foundation / computers / create-edit-delete

  • a03

    環境のコピー

    コンピューターを別のプロジェクトやサーバーに複製します。

    リンクhttps://api.hoody.com

    AIに伝える内容
    ステージング環境のコピーを作ってください。

    補足コピーにはSSHキーが付きません。ファイアウォールのルール、プロキシのエイリアス、スナップショットは、コピー元に残ります。

    docs / foundation / computers / copy-sync

  • a04

    すぐに使えるDebian 13

    コンピューターはDebian 13で起動し、開発ツールも用意されています。

    リンクhttps://api.hoody.com

    AIに伝える内容
    サイドプロジェクト用に新しいコンピューターをセットアップしてください。

    docs / foundation / computers / images

  • a05

    プロジェクトとレルム

    コンピューターをプロジェクトにまとめます。レルム(コンピューターのグループ)で、トークンごとに見られるものと操作できるものを制限できます。

    リンクhttps://api.hoody.com

    AIに伝える内容
    クライアントのトークンでは、そのクライアントのプロジェクトだけが見えるようにしてください。

    docs / concepts / realms-projects

  • a06

    自動化用のトークン

    スクリプトやAIごとに専用のトークンを発行し、必要な範囲だけに限定します。

    リンクhttps://api.hoody.com

    AIに伝える内容
    デプロイスクリプト用のトークンを作ってください。30日で失効し、サーバーのIPからのみ使えるようにしてください。

    docs / foundation / hoody-api / authentication

  • a07

    コマンドライン

    ノートパソコンの`hoody`コマンドから、Hoodyのほとんどの操作を実行できます。

    入力curl -fsSL https://install.hoody.com | sh

    AIに伝える内容
    Hoody CLIをインストールして、ログインしてください。

    補足cronジョブを今すぐ実行するなど、一部の操作にはSDKかHTTP APIが必要です。

    docs / foundation / cli

  • a08

    オープンソースのSDK

    オープンソースのSDKを使うと、TypeScriptでHoodyを使ったアプリを作れます。

    入力npm install hoody-sdk

    AIに伝える内容
    Hoody SDKで、コンピューターの一覧を表示するスクリプトを書いてください。

    docs / getting-started / quickstart

  • a09

    どのAIでも読めるマニュアル

    AIは1つのマニュアルを読むだけで、Hoodyの使い方を覚えます。

    リンクhttps://hoody.com/SKILLS/

    AIに伝える内容
    hoody.com/SKILLSを読んで、セットアップしてください。

    補足ログインするには、AIがネットワークにアクセスできる状態でコードを実行できる必要があります。

    docs / foundation / agent-skill-bundle

  • a19

    スナップショットからコピー

    コピー元から選んだスナップショットで、独立したコンピューターを作成します。

    リンクhttps://api.hoody.com/api/v1/computers/{id}/copy

    AIに伝える内容
    テスト済みのスナップショットから、ステージング用のコンピューターを作成してください。

    補足コピーには、コピー元コンピューターの現在の環境変数が引き継がれます。スナップショットの履歴とSSHキーはコピーされません。

    docs / foundation / computers / copy-sync

  • a20

    ネットワークルールをコピー

    コンピューターのファイアウォールとネットワークルールを、新しいコピーに引き継ぎます。

    リンクhttps://api.hoody.com/api/v1/computers/{id}/copy

    AIに伝える内容
    ステージング用のコンピューターを、ファイアウォールとネットワークルールごとコピーしてください。

    補足ルールはデフォルトではコピーされません。ネットワークまたは起動の失敗により、コピーが停止したままになることがあります。

    docs / foundation / computers / copy-sync

  • a21

    環境変数をマージ

    複数の環境変数を更新します。ほかの設定は削除されません。

    リンクhttps://api.hoody.com/api/v1/computers/{id}/env

    AIに伝える内容
    コンピューターにデータベースURLとログレベルを設定してください。

    補足1回のリクエストで指定できる変数は1〜256個です。実行中のプロセスは、再実行するまで変更を反映しません。

    docs / api / computer-env

  • a22

    コンピューターのステータス履歴

    コンピューターの状態変化を確認し、予期しない停止や起動の遅さを調べます。

    リンクhttps://api.hoody.com/api/v1/computers/{id}/status-logs

    AIに伝える内容
    コンピューターがいつ停止したか、何がきっかけだったかを表示してください。

    docs / foundation / computers / managing

プロジェクト・トークン・ログイン 11

  • a23

    プロジェクトのアクセスレベル

    ほかのユーザーに、プロジェクトの閲覧、編集、削除の権限を付与します。

    リンクhttps://api.hoody.com/api/v1/projects/{id}/permissions

    AIに伝える内容
    Samにプロジェクトの閲覧権限を付与してください。

    補足所有者であるか、編集権限が必要です。アクセスはすぐに適用されます。

    docs / api / projects

  • a24

    プロジェクトのコンピューター台数上限

    プロジェクトの作成時または更新時に、コンピューター台数の上限を設定します。

    リンクhttps://api.hoody.com/api/v1/projects/{id}

    AIに伝える内容
    このプロジェクトのコンピューターを5台までに制限してください。

    補足所有者であるか、編集権限が必要です。クォータの最小値は0です。

    docs / api / projects

  • a25

    プロジェクトのリソース統計

    プロジェクト内の各コンピューターのリソース統計を、1回のレスポンスで取得します。

    リンクhttps://api.hoody.com/api/v1/projects/{id}/stats

    AIに伝える内容
    プロジェクト内のコンピューターのリソース使用量を表示してください。

    補足統計を読み取れなかったコンピューターには、プレースホルダーのエントリーが入ることがあります。

    docs / api / projects

  • a26

    プロジェクトの月間トラフィック

    プロジェクト全体の、プロキシ経由のリクエスト数とレスポンスのバイト数を、月ごとに取得します。

    リンクhttps://api.hoody.com/api/v1/projects/{id}/proxy-usage

    AIに伝える内容
    プロジェクトのプロキシ経由トラフィックを、直近3か月分表示してください。

    補足リクエストできる期間は最大12か月です。合計は不完全な場合があり、削除済みのコンピューター、直接のSSH、生の外向き通信、そのほかのトラフィックは含まれません。

    docs / api / projects

  • a27

    現在のトークンを確認

    現在のAPIトークンの権限とレルムの制限を確認します。

    リンクhttps://api.hoody.com/api/v1/auth/tokens/me

    AIに伝える内容
    現在のトークンでアクセスできる範囲を表示してください。

    docs / api / auth-tokens

  • a28

    トークン権限テンプレート

    トークンを作成する前に、権限テンプレートと、そこから展開される権限を一覧表示します。

    リンクhttps://api.hoody.com/api/v1/auth/tokens/templates

    AIに伝える内容
    使えるトークン権限テンプレートを表示してください。

    docs / api / auth-tokens

  • a29

    トークン権限をコピー

    別のトークンの権限、レルム、IPホワイトリストを引き継いだトークンを作成します。

    リンクhttps://api.hoody.com/api/v1/auth/tokens/{id}/copy

    AIに伝える内容
    このトークンの制限を、新しいトークンにコピーしてください。

    補足コピーには新しいシークレット値が付きます。

    docs / api / auth-tokens

  • a30

    トークンのレルムを調整

    制限付きの既存トークンに、レルムを追加または削除します。

    AIに伝える内容
    このトークンにステージングのレルムを追加してください。

    補足レルムが限定されたトークンから、最後のレルムは削除できません。

    docs / api / auth-tokens

  • a31

    レルム別のリソース数

    レルムを一覧表示し、プロジェクト、コンピューター、サーバー、トークンの数を示します。

    リンクhttps://api.hoody.com/api/v1/realms/?include_usage=true

    AIに伝える内容
    各レルムのリソース数を数えてください。

    補足リクエストにはresources.realms権限が必要です。

    docs / api / realms

  • a32

    デバイスコードでログイン

    ユーザーが入力できる短いコードで、デバイスのログインを開始します。

    リンクhttps://api.hoody.com/api/v1/auth/device/code

    AIに伝える内容
    アプリのデバイスコードログインを開始してください。

    補足フローはRFC 8628を参考にしていますが、標準に準拠したデバイスグラントではありません。

    docs / api / authentication

  • a33

    アプリのIDクレーム

    Hoodyでこのユーザーがログインしたことを、アプリに証明します。公開鍵を使い、オフラインで検証できます。

    リンクhttps://api.hoody.com/api/v1/users/auth/identity-claim

    AIに伝える内容
    アプリのIDクレームを発行してください。

    補足ログイン済みのセッションのみで、認証トークンは使えません。クレームの有効期間はデフォルトで1時間で、セッションより長くなることはありません。

    docs / api / authentication

コマンドラインツール 5

  • a34

    CLIのアカウントプロファイル

    アカウントや環境ごとに、CLIの設定とログインを切り替えます。

    AIに伝える内容
    ステージング用に、別のCLIプロファイルを設定してください。

    docs / foundation / cli

  • a35

    CLIリクエストをプレビュー

    CLIコマンドが送信するHTTPリクエストを確認します。curlの1行コマンドとして取得することもできます。

    AIに伝える内容
    このコンピューターを削除するHTTPリクエストを表示してください。

    補足シークレット値は伏せられ、一部のボディは返されません。名前での検索でも、GETリクエストが送られることがあります。

    docs / foundation / cli

  • a36

    CLI操作の完了を待つ

    時間のかかる操作が終わるまで、スクリプトを待機させます。

    AIに伝える内容
    このコンピューターをコピーし、コピーが完了するまで待ってください。

    補足待機のタイムアウトは、デフォルトで10分です。

    docs / foundation / cli / reference

  • a37

    CLIの一覧を監視

    リソースの変化に合わせて、CLIの一覧を繰り返し更新します。

    AIに伝える内容
    コンピューターの一覧を、5秒ごとに更新して表示してください。

    補足対話型のターミナルが必要です。間隔はデフォルトで2秒です。

    docs / foundation / cli / reference

  • a38

    ローカルのCLI認証情報をロック

    保存済みのCLIトークンと既定のIDを、パスワードで暗号化します。

    AIに伝える内容
    保存済みのCLI認証情報を、パスワードで保護してください。

    補足ロックをオンにすると、保存されているアカウントのパスワードが削除されます。

    docs / foundation / cli / reference

エージェントの構成要素 4

  • a39

    単発のモデル応答

    エージェントセッションを使わず、アプリ用にモデルの返答を1件取得します。JSONまたはストリーミングで受け取れます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/completions

    AIに伝える内容
    このテキストに対する単発のモデル応答を取得してください。

    補足セッション、トランスクリプト、ツールの使用はありません。呼び出しはすべて課金されます。

    docs / api / agent / models

  • a40

    ツールを直接実行

    エージェントのツールを直接呼び出し、結果をアプリで受け取ります。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/tools/{name}/run

    AIに伝える内容
    このエージェントのツールを呼び出し、結果を返してください。

    補足何かを変更するツールは、有効にしたときだけ実行され、先に確認を求める場合があります。このコンピューター上でのみ実行されます。

    docs / api / agent / tools

  • a41

    エージェントのツールを確認

    エージェントの組み込みツールを一覧表示し、入力スキーマを確認します。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/tools

    AIに伝える内容
    エージェントの組み込みツールの入力を表示してください。

    docs / api / agent / tools

  • a42

    エージェントのデータ変更を監視

    変更通知をストリーミングし、アプリが影響を受けたエージェントのデータを更新できるようにします。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/changes/stream

    AIに伝える内容
    エージェントのデータが変わったら、ダッシュボードを更新してください。

    補足トークンが示すのは、どの一覧が変わったかだけです。アプリは該当の一覧を読み直します。

    docs / api / agent / changes

アプリとAIモデル 14

  • a10

    ライブツールの埋め込み

    動作中のターミナル、デスクトップ、エディター、データベースをページに埋め込めます。

    リンクhttps://{p}-{c}-terminal-1.{node}.computers.hoody.com iframeで

    AIに伝える内容
    ダッシュボードのページ内に、動作中のターミナルを表示してください。

    補足他の人から見えるリンクを埋め込む前に、プロキシの権限を設定してください。

    docs / guides / embed-urls

  • a11

    リクエストのたびにExecスクリプト

    条件に合うリクエストは、まずExecスクリプトに届きます。確認、変更、応答ができます。

    AIに伝える内容
    指定のヘッダーがないリクエストを拒否するチェックを追加してください。

    補足一致するパスへのWebSocketアップグレードは拒否されるため、そのパスは一致の対象から外してください。フックは500ミリ秒でタイムアウトします。最大30秒まで設定できます。

    docs / foundation / proxy / hooks

  • a12

    リンクで使えるAIモデル

    コンピューターから、APIキーなしで多数のAIモデルを呼び出せます。

    AIに伝える内容
    低価格のモデルで、この1,000枚の写真にタグを付けてください。

    補足有料モデルは使用ごとにAI残高から請求され、無料モデルにはサーバーごとの上限があります。OpenAI、Anthropic、Googleのモデルは含まれません。

    docs / foundation / hoody-ai

  • a13

    AI呼び出しの監視

    AIの呼び出しをExecスクリプト経由にして、ログの記録、キャッシュ、変更ができます。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1

    AIに伝える内容
    アプリが行うAI呼び出しをすべて記録してください。

    docs / foundation / hoody-ai / mitm

  • a14

    音声の入力と出力

    テキストを音声に、音声をテキストに変換します。

    リンクhttps://ai.hoody.com/api/v1/audio/speech · `.../audio/transcriptions`

    AIに伝える内容
    この記事を音声ファイルとして読み上げてください。

    補足サーバーの音声の上限内であれば無料で、コンピューター内から使えます。

    docs / foundation / hoody-ai / usage

  • a16

    無料のWeb検索

    コンピューター内のコードは、APIキーなしでWeb検索ができます。サーバーの上限内なら無料です。

    入力POST https://ai.hoody.com/api/v1/coding_plan/search

    AIに伝える内容
    このエラーを他の人がどう直したか、Webで検索してください。

    補足サーバーの上限内であれば無料で、コンピューター内から使えます。

    docs / foundation / hoody-ai / usage

  • a17

    AIによる「はい/いいえ」の回答

    Hoody AIに、はい/いいえ、択一、スコア付けの質問をすると、それぞれの答えの確率が返ってきます。

    入力POST https://ai.hoody.com/api/v1/decisions

    AIに伝える内容
    サポートチケットごとに、緊急かどうかをAIに判断させてください。

    補足サーバーの上限内であれば無料で、コンピューター内から使えます。

    docs / foundation / hoody-ai / decisions

  • a18

    コンピューターごとのAIスイッチ

    コンピューターごとにAIのオンとオフを切り替え、それぞれの使用量を確認できます。

    AIに伝える内容
    クライアントのコンピューターでAIをオフにしてください。

    docs / foundation / hoody-ai / security

  • a43

    特定のビューを開く

    選んだファイルエディター、ターミナルセッション、データベースのテーブルビューへのリンクを作成します。

    AIに伝える内容
    usersテーブルビューへのリンクを作ってください。

    補足パラメーターが必要なビューがあります。フレーム表示を拒否するビューは、新しいタブで開く必要があります。

    docs / guides / embed-urls

  • a44

    APIをインポート

    別のAPIのOpenAPIドキュメントを、呼び出しを転送するスクリプトのエンドポイントに変換します。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/sdk/import

    AIに伝える内容
    このAPI仕様を、スクリプトのエンドポイントとしてインポートしてください。

    docs / kit / exec / reference

  • a45

    スクリプトAPIをドキュメント化

    スクリプトのOpenAPI仕様を生成します。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/user-openapi/generate

    AIに伝える内容
    スクリプトのOpenAPI仕様を生成してください。

    docs / api / exec / routing

  • a46

    サービスのレスポンスを書き換える

    サービスのレスポンスが呼び出し元に届く前に、内容を確認して変更します。

    AIに伝える内容
    アプリのレスポンスにヘッダーを追加してください。

    補足フックに一致するパスでのWebSocketアップグレードは拒否されます。フックは、1つのサービスにつき最大8個、1台のコンピューターにつき最大32個です。

    docs / foundation / proxy / hooks

  • a47

    訪問者のIPを取得

    Hoodyのリンク経由で届くアプリで、訪問者の実際のIPアドレスを読み取ります。

    AIに伝える内容
    アプリのアクセスログに、訪問者のIPを表示してください。

    補足プロキシフックがリクエストを転送する場合、アプリには代わりにフックの接続アドレスが見えます。

    docs / foundation / proxy

  • a48

    訪問者のネットワークを照会

    訪問者のパブリックIPv4アドレスについて、国とネットワークの情報を照会します。

    リンクhttps://api.hoody.com/api/v1/ip/lookup?ip={ips}

    AIに伝える内容
    これらの訪問者IPの国を表示してください。

    補足1回の検索で調べられる公開IPv4アドレスは最大25個です。Hoodyにデータがないアドレスはnullを返します。

    docs / foundation / proxy

Hoody AIのモデル 8

  • a49

    モデルカタログを見る

    利用できるモデルを、コンテキスト長、モダリティ、現在の料金とともに一覧表示します。

    リンクhttps://api.hoody.com/api/v1/ai/models

    AIに伝える内容
    利用できるAIモデルとコンテキスト長を一覧表示してください。

    補足カタログはキャッシュされます。OpenAI、Anthropic、Googleのモデルは含まれません。

    docs / api / ai-models

  • a50

    モデルの回答をストリーミング

    モデルが回答を生成するのに合わせて、ユーザーにテキストを表示します。

    AIに伝える内容
    回答をチャットアプリにストリーミングしてください。

    補足AIを有効にしたコンピューターの中から呼び出します。

    docs / foundation / hoody-ai / usage

  • a51

    コーディングアシスタントと連携

    コンピューターのCline、Cursor、WindsurfでHoody AIを使えるようにします。

    AIに伝える内容
    コンピューターのClineをHoody AIに連携させてください。

    補足ツールはコンピューターの中で実行する必要があります。CursorのTab補完は、引き続きCursor内蔵のモデルを使います。

    docs / foundation / hoody-ai

  • a52

    モデルのツール呼び出しを使う

    チャットリクエストにツール定義を添えて送信し、対応モデルに使わせます。

    AIに伝える内容
    モデルが天気の関数を呼び出せるようにしてください。

    補足回答するモデルがツールに対応している場合に使えます。AIを有効にしたコンピューターの中から呼び出します。

    docs / foundation / hoody-ai / models

  • a53

    スクリーンショットで判定

    スクリーンショットについて、「はい」か「いいえ」で答えられる質問をHoody AIに投げかけます。たとえば、ページが崩れていないかを確認できます。

    AIに伝える内容
    この決済ページのスクリーンショットに崩れがないか確認してください。

    補足PNG、JPEG、WebP、GIFに対応し、1リクエストあたり最大4枚、デコード後で1枚あたり1MiBまでです。リモートの画像URLは拒否されます。

    docs / foundation / hoody-ai / decisions

  • a54

    自分のモデルで判定

    エージェントを通じて、「はい」か「いいえ」の質問、択一の質問、スコア付けの質問をします。回答するのは、選んだモデルです。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/jev/decide

    AIに伝える内容
    設定済みのモデルで、このチケットを分類するようエージェントに頼んでください。

    補足ほかのプロバイダーのモデルには、そのプロバイダーのキーが必要です。

    docs / foundation / hoody-ai / decisions

  • a55

    無料のAI利用枠を確認

    アカウントが、サーバーごとの無料AI利用枠をどれくらい使ったか、おおよその量を確認します。

    リンクhttps://api.hoody.com/api/v1/users/me/free-ai-usage

    AIに伝える内容
    サーバー別の無料AI使用量を表示してください。

    補足読み取り値は概算です。認証トークンには`computers.read`が必要で、レルムが限定されたトークンでは`403`が返ります。

    docs / foundation / hoody-ai / models

  • a56

    AI使用記録を削除

    指定した時点より古い、コンピューターのAI使用記録を削除します。

    AIに伝える内容
    このコンピューターの1月より前のAI使用記録を削除してください。

    補足削除は、呼び出したコンピューターにのみ適用されます。処理中のリクエストの行は削除されません。

    docs / foundation / hoody-ai / security / reference

音声とオーディオ 5

  • a57

    主要な音声形式を文字起こし

    WAV、MP3、WebM、OGG、M4A、FLACの録音をテキストに変換します。アップロードでもbase64でも渡せます。

    AIに伝える内容
    このM4Aのボイスメモを文字起こししてください。

    補足音声は25MB(25,000,000バイト)、600秒までです。音声のURLは拒否されます。コンピューターの中から使えます。

    docs / foundation / hoody-ai / models / reference

  • a58

    読み上げ音声を選択

    4つの音声から1つを選ぶと、テキストをPCMまたはMP3の音声で受け取れます。

    AIに伝える内容
    このノートをBellaの音声で読み上げ、MP3にしてください。

    補足テキストは4,096文字までです。Hoody Voiceは、サーバーの音声制限の範囲内で、コンピューターの中から使えます。

    docs / foundation / hoody-ai / models / reference

  • a59

    音声をストリーミング

    生成した音声を、でき次第アプリにストリーミングします。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/audio/speech/stream

    AIに伝える内容
    音声の回答をアプリにストリーミングしてください。

    補足音声をストリーミングするモデルだけが対象です。

    docs / api / agent / audio

  • a60

    文字起こしにタイムスタンプを付ける

    セグメントとタイミングの情報がある場合は、それらを含む文字起こしを取得します。

    AIに伝える内容
    この録音を、セグメントごとのタイムスタンプ付きで文字起こししてください。

    補足音声は25MB(25,000,000バイト)、600秒までです。セグメントのフィールドは、欠けていたりnullだったりする場合があります。

    docs / foundation / hoody-ai / models / reference

  • a61

    音声モデルを探す

    音声モデルを一覧表示し、文字起こしまたは音声生成の機能で絞り込みます。

    リンクhttps://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/audio/models

    AIに伝える内容
    エージェントが使える音声認識モデルを一覧表示してください。

    補足一覧にあるモデルでも、呼び出しに使えない場合があります。

    docs / api / agent / audio

AIリクエストのプロキシ 4

  • a62

    リスクのあるAIリクエストを確認

    AIリクエストをプロキシで保留し、人が承認または却下するまで止めておきます。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1

    AIに伝える内容
    リスクのあるAIリクエストは、承認するまで保留してください。

    補足承認と拒否のスクリプトは自分で追加します。ない場合、保留中のリクエストは408で終了します。

    docs / foundation / hoody-ai / mitm

  • a63

    プロンプトに知識を追加

    プロキシのスクリプトで、ナレッジベースの検索結果をプロンプトに追加します。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1

    AIに伝える内容
    関連する社内ドキュメントを、AIへのプロンプトごとに追加してください。

    補足プロキシを共有する前に、スクリプトトークンとプロキシの権限で保護してください。

    docs / foundation / hoody-ai / mitm

  • a64

    別のプロバイダーに振り分け

    プロキシのスクリプトで、AIリクエストを選んだプロバイダーに送ります。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1

    AIに伝える内容
    このアプリのAIリクエストを、自分のプロバイダーに振り分けてください。

    補足プロバイダーのキーとプロキシのセキュリティは、自分で管理します。

    docs / foundation / hoody-ai / mitm

  • a65

    AIのツール呼び出しを書き換える

    クライアントが実行する前に、プロキシでモデルのツール呼び出しを変更します。

    リンクhttps://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1

    AIに伝える内容
    AIのファイル書き込みを、確認用フォルダーに振り向けてください。

    補足書き換えは経路の振り分けで、閉じ込めではありません。制限は、呼び出しを実行するツール側で適用してください。

    docs / foundation / hoody-ai

hoody / capabilities / across

04 58 項目

すべてに共通

どこから使っても、すべてに当てはまることです。

リンク、共有、安全性 12

  • x01

    すべてがURL

    ツール、ファイル、アプリ、Botのそれぞれに専用のリンクがあります。

    リンクhttps://{p}-{c}-<kit>-1.{node}.computers.hoody.com

    AIに伝える内容
    そのリンクを送ってください。

    docs / concepts / everything-is-a-url

  • x02

    リアルタイムで共同作業

    リンクを共有すると、同じターミナル、デスクトップ、エディターで同時に作業できます。

    AIに伝える内容
    ターミナルをSamと共有してください。一緒に直します。

    補足リンクに?sharing=true&steal=falseがないと、2人目がデスクトップを開いた時点で、1人目から操作が引き継がれます。

    docs / guides / multiplayer

  • x03

    人とAIが一緒に作業

    人とAIが、同じツールで並んで作業します。組み合わせは自由です。

    AIに伝える内容
    様子を見ながら、同じデスクトップでAIに作業させてください。

    docs / guides / multiplayer

  • x04

    スナップショットと取り消し

    コンピューターのストレージのスナップショットを保存し、1回の操作で復元できます。

    リンクhttps://api.hoody.com

    AIに伝える内容
    変更する前に、スナップショットを作成してください。

    補足同じサーバー上のロールバック地点で、バックアップではありません。コンピューターを削除すると、一緒に削除されます。復元すると現在のストレージが置き換わり、それ以降の変更は破棄されます。マウントされたストレージと実行中のプロセスは保存されません。

    docs / concepts / snapshots

  • x05

    非公開リンク

    生成されたリンクは推測されにくいですが、ロックしていないリンクは漏れる可能性があります。リンクを入手した人は誰でも使えます。短いリンクは推測される可能性があります。アクセスを確実に制御するには、リンクをロックします。

    AIに伝える内容
    このリンクは非公開ですか?

    docs / concepts / security

  • x06

    リンクをロック

    コンピューターのリンクにパスワード、ログイン、IPリストを追加し、グループが開けるプログラムを選びます。

    AIに伝える内容
    共有する前に、デスクトップのリンクにパスワードを設定してください。

    docs / foundation / proxy / permissions

  • x07

    何が起きたかを確認

    ログイン、認証済みのAPI呼び出しと使われたトークン、各コンピューターが配信したトラフィックを確認できます。

    AIに伝える内容
    今週、AIのトークンが行ったAPI呼び出しを表示してください。

    docs / concepts / auditing

  • x08

    暗号化ボールト

    パスワードとキーを保管庫に入れておけます。暗号化は、項目ごとにオンにできます。

    AIに伝える内容
    Stripeのキーをボールトに保存してください。

    docs / kit / agent / reference

  • x23

    暗号化されたディスク

    コンピューターのディスクは、Hoodyのすべてのサーバーで保存時に暗号化されます。

    AIに伝える内容
    コンピューターのディスクは暗号化されていますか?

    補足ディスクの暗号化では、稼働中のサーバー上のデータは保護されません。

    docs / concepts / security

  • x24

    URLへのアクセスを一時停止

    インシデントを調査している間、コンピューターのURLへの新しいリクエストを遮断します。

    リンクhttps://api.hoody.com/api/v1/computers/{c}/proxy/permissions/state

    AIに伝える内容
    このコンピューターのURLへのアクセスを一時停止してください。

    補足適用に数秒以上かかることがあります。SSHと、確立済みのWebSocketまたはCONNECTトンネルは開いたままです。

    docs / concepts / security

  • x25

    期限付きスナップショット

    コンピューターのスナップショットに、指定した日数で期限が切れるよう設定します。

    リンクhttps://api.hoody.com/api/v1/computers/{id}/snapshots

    AIに伝える内容
    デプロイ前のスナップショットを作成し、30日で期限が切れるようにしてください。

    補足有効期限は、1〜3,650の整数の日数です。作成後に`expires_at`を確認してください。作成に成功しても、nullのままの場合があります。

    docs / foundation / computers / snapshots

  • x26

    スナップショットにラベルを付ける

    動作確認済みのコンピューターの状態を示すため、スナップショットのラベルを変更します。

    リンクhttps://api.hoody.com/api/v1/computers/{id}/snapshots/{name}/alias

    AIに伝える内容
    そのスナップショットに「テスト済みリリース」というラベルを付けてください。

    補足エイリアスは100文字までです。エイリアスを変更しても、スナップショットの名前は変わりません。

    docs / foundation / computers / snapshots

リンクのアクセスルール 8

  • x27

    Hoodyユーザーのみ

    ログイン済みのHoodyユーザー、または指定したユーザーIDだけが、サービスを呼び出せるようにします。

    AIに伝える内容
    ログイン済みのHoodyユーザーだけが、APIを呼び出せるようにしてください。

    補足呼び出し元は、署名付きのHoodyの本人確認クレームをヘッダーで送ります。許可リストには、ユーザーIDを最大256件登録できます。

    docs / api / proxy-permissions

  • x28

    パートナー用アクセストークン

    ヘッダー、Cookie、クエリパラメーターのトークンで、パートナーにアクセスを許可します。

    AIに伝える内容
    パートナーにAPI用のトークンを発行してください。

    補足グループにはプログラムの許可が必要です。どれにも一致しない呼び出し元には、デフォルトのポリシーが引き続き適用されます。

    docs / foundation / proxy / permissions

  • x29

    アプリ用のJWTアクセス

    アプリのユーザーが、アプリの発行するトークンで、指定したサービスを開けるようにします。

    AIに伝える内容
    アプリのサービスには、そのアプリのJWTを必須にしてください。

    補足グループにはプログラムの許可が必要です。どれにも一致しない呼び出し元には、デフォルトのポリシーが引き続き適用されます。

    docs / foundation / proxy / permissions

  • x30

    新しいサービスを保護

    デフォルトを拒否に設定すると、後から追加したプログラムは、許可するまで閉じたままになります。

    AIに伝える内容
    新しいサービスは、アクセスを許可するまで閉じたままにしてください。

    補足先にグループを設定してください。allowの場合、新しいプログラムは最初から開放されます。

    docs / foundation / proxy / permissions

  • x31

    プロジェクト全体のURLルール

    URLアクセスのルールをプロジェクト全体に適用し、コンピューターごとに上書きできます。

    AIに伝える内容
    チームのアクセスポリシーをこのプロジェクトに適用してください。

    補足重なる部分ではコンピューターの値が優先されます。コンピューターが指定していないプロジェクトのグループは、そのまま有効です。

    docs / foundation / proxy / permissions

  • x32

    アプリのポートを選んで許可

    HTTPまたはHTTPSアプリの特定のポートへのアクセスを、アクセスグループに許可します。

    AIに伝える内容
    パートナーグループがポート8080にアクセスできるようにしてください。

    補足1つのセルで開けるポートは最大16,384個です。許可を与えると、それらのポートで待ち受けているものはすべて開放されます。

    docs / foundation / proxy / permissions

  • x33

    ターミナルのインスタンスを選ぶ

    コンピューターの特定のターミナルインスタンスへのアクセスを、グループに許可します。

    AIに伝える内容
    チームがターミナル1と2を使えるようにしてください。

    補足どれにも一致しない呼び出し元を締め出すには、デフォルト拒否のポリシーを設定します。

    docs / foundation / proxy / permissions

  • x34

    サービスのアクセスを確認

    サービスのグループアクセス、フック、有効なデフォルト設定をまとめて確認します。

    リンクhttps://api.hoody.com/api/v1/computers/{id}/proxy/services/{service}

    AIに伝える内容
    ターミナルのアクセスルールを表示してください。

    docs / api / proxy-discovery

アクセス方法 7

  • x09

    @hoody.comと伝える

    AIに「@https://hoody.com Connect to Hoody」と伝えると始められます。

    入力@https://hoody.com

    AIに伝える内容
    @https://hoody.com Connect to Hoody

    補足ログインするには、AIがネットワークにアクセスできる状態でコードを実行できる必要があります。

    docs / getting-started / quickstart

  • x10

    ssh hoody.com

    どのターミナルでも`ssh hoody.com`と入力します。クリックすると、ブラウザーで開きます。

    入力ssh hoody.com · `https://ssh.hoody.com`

    AIに伝える内容
    ターミナルから接続するにはどうすればよいですか?

    docs / foundation / cli

  • x11

    どのブラウザーでも開く

    どのデバイスからでもhub.hoody.comにログインすると、Hubが開きます。コンピューターとエージェントを操作できます。

    リンクhttps://hub.hoody.com

    AIに伝える内容
    ブラウザーでHoodyを開いてください。

    docs / kit / agent

  • x12

    スマートフォン優先

    すべてをスマートフォンから使え、作ったものをアプリとしてインストールできます。

    AIに伝える内容
    このダッシュボードをスマートフォンにインストールできるようにしてください。

    docs / vision / embeddability

  • x13

    独自のOSを作る

    素のHTMLで、独自のWebデスクトップやワークフロー全体を作れます。

    AIに伝える内容
    ターミナル、ノート、サイトを並べたホーム画面を作ってください。
  • x35

    ターミナルで使うHub

    アカウントのHubを、対話型ターミナルで全画面表示します。

    AIに伝える内容
    ターミナルでHubを開いてください。

    補足スタンドアロンのターミナルHubは、Linux x64とarm64向けに提供され、コンピューター内やホスト型CLIからも使えます。npm版にはNode.js 26以上が必要です。

    docs / foundation / cli

  • x36

    サンプルアカウントを試す

    ログインなしで、サンプルアカウントを使ってターミナルのHubを試せます。

    AIに伝える内容
    Hubのサンプルアカウントを開いてください。

    補足ターミナルHubには、対話型のターミナルが必要です。

    docs / foundation / cli

手持ちのAIとプランで 6

  • x14

    ChatGPTまたはClaudeのプラン

    ChatGPTのプラン、Claude Code経由のClaudeのプラン、または無料の内蔵AIを使えます。

    AIに伝える内容
    ChatGPTのプランでログインしてください。

    補足Claudeのプランは、コンピューター上のClaude Codeを通して使い、Claude Code自身のログインで認証します。新しいHubの会話が対象で、Botは対象外です。

    docs / kit / agent

  • x15

    Hoody AI(無料)

    キーや設定が不要な、無料の内蔵AIです。コンピューター内から使えます。

    AIに伝える内容
    当面は無料のモデルを使ってください。

    補足上限はサーバー単位で、そのサーバーのすべてのコンピューターで共有されます。

    docs / foundation / hoody-ai / models

  • x16

    AIを切り替えても、すべてそのまま

    AIはいつでも変更できます。ファイル、プロジェクト、メモリ、タスクはそのまま残ります。

    AIに伝える内容
    作業内容を新しいAIに引き継いでください。
  • x17

    無料で始められる

    無料で始められます。無料サーバー1台で、動き続けるコンピューターを最大3台まで使えます。

    AIに伝える内容
    Freeプランでセットアップしてください。

    補足無料サーバーは、対象アカウントごとに1台です。無料枠の空きがある間に限ります。

    docs / foundation / pricing

  • x18

    費用に見合うときに拡張

    さらに余裕が必要なときは、PlusまたはProのサーバーを追加するか、Bare metalでサーバー1台を丸ごと借りられます。

    AIに伝える内容
    このプロジェクト用に、より大きなサーバーを借りてください。

    補足無料サーバーは、そのままではアップグレードできません。有料サーバーは月額10ドルからです。

    docs / foundation / pricing

  • x19

    支払い方法を選べる

    カードまたは暗号資産で支払えます。サーバーはチームと、役割ごとに共有できます。

    AIに伝える内容
    暗号資産で残高をチャージしてください。

    docs / foundation / billing

サーバーとプラン 9

  • x37

    リージョンでサーバーを探す

    借りる前に、利用できるサーバーを場所、スペック、価格で絞り込みます。

    AIに伝える内容
    ヨーロッパのユーザーに近いサーバーを探してください。

    補足レンタルは1日からです。料金は、掲載ごと、レンタル期間ごとに異なります。

    docs / foundation / servers

  • x38

    販売中のプランを見る

    販売中の有料サーバープランを、短いリンクとBot URLの上限つきで一覧表示します。

    リンクhttps://api.hoody.com/api/v1/subserver-plans

    AIに伝える内容
    販売中の有料サーバープランを表示してください。

    補足購入見積もりで、その時点でプランを購入できるかどうかが分かります。

    docs / foundation / pricing

  • x39

    PlusからProへアップグレード

    PlusサーバーをProにアップグレードします。IDとデータはそのままです。

    AIに伝える内容
    PlusサーバーをProにアップグレードしてください。

    補足アップグレードでは、現在の期間の残りについて差額が請求されます。実行中のコンピューターは再起動し、停止中のコンピューターは停止したままです。

    docs / foundation / pricing

  • x40

    サーバープランの見積もり

    購入前に、有料サーバープランの現在の価格と空き容量を確認します。

    リンクhttps://api.hoody.com/api/v1/subserver-subscriptions/quote

    AIに伝える内容
    Plusサーバープランの現在の価格を見積もってください。

    docs / api / servers

  • x41

    無料サーバーの申請資格を確認

    アカウントで無料サーバーを受け取れるかどうか、受け取れない場合はその理由を確認します。

    リンクhttps://api.hoody.com/api/v1/users/me/free-tier-status

    AIに伝える内容
    このアカウントで無料サーバーを受け取れますか?

    補足エンドポイントは状態を返すだけで、サーバーを確保しません。認証トークンにはresources.read_account権限が必要です。

    docs / api / users

  • x42

    サーバーの更新設定

    有料サーバーの自動更新をオンまたはオフにします。

    リンクhttps://api.hoody.com/api/v1/subserver-subscriptions/{id}/auto-renew

    AIに伝える内容
    このサーバーの自動更新をオフにしてください。

    補足オンにできるのは、アカウントの所有者または認証トークンだけです。オフにすると、サーバーは支払い済み期間の終了時に停止できるようになります。

    docs / api / servers

  • x43

    サーバーのレンタルを延長

    APIで、既存のサーバーレンタルに日数を追加します。

    リンクhttps://api.hoody.com/api/v1/rentals/{id}/extend

    AIに伝える内容
    サーバーのレンタルを30日延長してください。

    補足追加日数は1〜3,650の範囲で、サーバーの料金設定に合う値にする必要があります。

    docs / api / servers

  • x44

    提示されたサーバーを予約

    在庫切れのマシンを、上限額を決めて納品のために予約します。

    リンクhttps://api.hoody.com/api/v1/offers/{id}/reserve

    AIに伝える内容
    このサーバーのオファーを30日間予約してください。

    補足予約は、すぐに請求されます。有料の予約には、請求上限額と冪等性キーが必要です。

    docs / api / servers

  • x45

    Bare metalサーバーのコマンド

    APIで、借りているBare metalサーバーの稼働時間やメモリを確認したり、再起動したりします。

    リンクhttps://api.hoody.com/api/v1/servers/{serverId}/execute-command

    AIに伝える内容
    Bare metalサーバーの稼働時間を確認してください。

    補足対象は組み込みコマンドのみです。レンタルが現在有効な、専有のBare metalサーバーで使えます。

    docs / api / server-management

アカウント 12

  • x20

    2要素認証

    認証アプリとバックアップコードで、アカウントを保護します。

    AIに伝える内容
    アカウントの2要素認証をオンにしてください。

    docs / api / authentication

  • x21

    紹介クレジットを受け取る

    紹介リンクを共有します。招待した人が支払うと、サーバー用のクレジットがたまります。

    AIに伝える内容
    Hoodyの紹介リンクを教えてください。

    補足サーバーの料金をカード決済または暗号資産で支払うと、使えるようになります。クレジットは60日間の保留後に付与され、利用者1人につき12か月間です。クレジットで支払えるのはサーバーのみです。

    docs / foundation / wallet / referral-program

  • x22

    サポートチケット

    サポートチケットを開き、返信をCLIまたはAPIから確認できます。

    リンクhttps://api.hoody.com/api/v1/support/tickets

    AIに伝える内容
    コンピューターが起動しない件で、サポートチケットを開いてください。

    docs / foundation / support

  • x46

    1つのログインを終了

    ほかのセッションは維持したまま、忘れていた端末1台だけログアウトします。

    リンクhttps://api.hoody.com/api/v1/users/auth/sessions/{id}

    AIに伝える内容
    古いノートパソコンのセッションをログアウトしてください。

    補足呼び出せるのは、自分のログイン済みセッションだけです。セッションを終了しても、その間に作成したトークンは削除されません。

    docs / api / authentication

  • x47

    ほかの端末をログアウト

    現在のログインは維持したまま、アカウントのほかのセッションをすべて終了します。

    リンクhttps://api.hoody.com/api/v1/users/auth/sessions/revoke-others

    AIに伝える内容
    ほかの端末をすべてログアウトしてください。

    補足呼び出せるのは、自分のログイン済みセッションだけです。各セッションを終了しても、そのセッション中に作成したトークンは削除されません。

    docs / api / authentication

  • x48

    バックアップコードを再発行

    古いバックアップコードが漏えいした場合に、2要素認証の新しいバックアップコードを生成します。

    リンクhttps://api.hoody.com/api/v1/users/auth/2fa/backup-codes/regenerate

    AIに伝える内容
    アカウントの2要素認証用に、新しいバックアップコードを生成してください。

    補足パスワードと現在のOTPコードが必要です。既存のバックアップコードは無効になります。

    docs / api / authentication

  • x49

    拒否されたログインを確認

    アカウントのセキュリティ履歴を確認するとき、失敗したログイン試行も含めます。

    リンクhttps://api.hoody.com/api/v1/users/me/security-history?include_failed=true

    AIに伝える内容
    アカウントで拒否されたログイン試行を表示してください。

    補足APIトークンにはresources.read_accountが必要です。アカウントの監査証跡は180日間保存されます。

    docs / concepts / auditing

  • x50

    アカウントのメールアドレスを変更

    アカウントの新しいメールアドレスを申請し、新しいアドレスで確認します。

    リンクhttps://api.hoody.com/api/v1/users/me/email-change

    AIに伝える内容
    アカウントのメールアドレスを変更してください。

    補足自分のログイン済みセッションと現在のパスワードが必要です。二要素認証が有効な場合は、そのコードも必要です。確認リンクの有効期間は24時間です。

    docs / api / users

  • x51

    サポート返信の通知

    チケットにサポートから返信があると、アプリ内で通知します。

    AIに伝える内容
    サポートから返信があったら知らせてください。

    補足1件のチケットへの複数の返信は、1つの通知にまとめられることがあります。通知は、1件のチケットにつき10分ごとに最大1件です。通知からチケットは特定できません。

    docs / foundation / support

  • x52

    カスタム紹介コード

    Hoodyに招待する人向けに、覚えやすい紹介コードを作成します。

    リンクhttps://api.hoody.com/api/v1/referrals/me/codes

    AIに伝える内容
    alex-buildsという紹介コードを作成してください。

    補足有効なバニティコードは、同時に最大3つ、アカウント全体で通算10個まで持てます。作成には、ログイン済みのセッションと、紹介プログラムへの参加が必要です。

    docs / foundation / wallet / referral-program

  • x53

    紹介の報酬を確認

    紹介コード、レベル、件数、クレジットの合計を確認します。

    リンクhttps://api.hoody.com/api/v1/referrals/me

    AIに伝える内容
    紹介レベルとクレジットの合計を表示してください。

    補足紹介された人の名前とアカウントの詳細は表示されません。認証トークンにはfinancial.wallet.readが必要で、レルムを限定していないものに限ります。

    docs / foundation / wallet / referral-program

  • x54

    紹介クレジットを出金

    Creatorレベルでは、利用可能な紹介クレジットを、サポート経由で現金として引き出せます。

    AIに伝える内容
    サポートに、紹介クレジットの出金を問い合わせてください。

    補足デフォルトではオフで、サポートが各リクエストを確認します。場合によっては、銀行振込または暗号資産が使われます。保留中のクレジットは引き出せません。

    docs / foundation / wallet / referral-program

残高と請求書 4

  • x55

    すべての残高を確認

    一般残高、紹介クレジット、AI残高を、1回の呼び出しで確認します。

    リンクhttps://api.hoody.com/api/v1/wallet/balances

    AIに伝える内容
    Hoodyの残高をすべて表示してください。

    補足ログイン済みのセッション、または該当の権限を持つアカウント全体の認証トークンを使います。レルムが限定されたトークンでは、残高を読み取れません。

    docs / foundation / billing

  • x56

    ウォレットの取引を確認

    支払い、請求、振替、返金を、1つの取引履歴で確認します。

    リンクhttps://api.hoody.com/api/v1/wallet/transactions

    AIに伝える内容
    最近のHoodyの請求と返金を表示してください。

    補足ログイン済みのセッション、または該当の権限を持つアカウント全体の認証トークンを使います。レルムが限定されたトークンでは、取引を読み取れません。

    docs / foundation / billing

  • x57

    請求書PDFをダウンロード

    経理、税務、取引先への請求に使えるよう、請求書をPDFでダウンロードします。

    リンクhttps://api.hoody.com/api/v1/wallet/invoices/{id}/pdf

    AIに伝える内容
    最新の請求書のPDFをダウンロードしてください。

    補足ログイン済みのセッション、または該当の権限を持つアカウント全体の認証トークンを使います。レルムが限定されたトークンでは、請求書を読み取れません。

    docs / foundation / billing

  • x58

    支払いを確認

    カードまたは暗号資産の支払いを、インテントIDで照会します。

    AIに伝える内容
    暗号資産でのチャージが反映されたか確認してください。

    補足支払いの検索には、ログイン済みのセッションが必要です。認証トークンは拒否されます。

    docs / foundation / billing

2021年から

プライバシーからエージェント向けインフラへ

hoody / kit

コンピューターに付属するもの

サービスにはそれぞれ専用のリンクがあります。開いたり、共有したり、AIに渡したりできます。リンクを知っている人は誰でも、ロックするまで開けます。Kitのリンクの形式はhttps://{p}-{c}-<kit>-1.{node}.computers.hoody.comです。{p}はプロジェクト、{c}はコンピューター1台、{node}はそのサーバーです。

コンピューター

Bots

API