harnsy Max
エージェントはキーを使えますが、見ることはできません。
GitHub やモデルプロバイダーが必要なエージェントは、harnsy にリクエストを頼みます。harnsy が送信時にキーを付け、あなたが登録したホストにだけ送ります。キーがエージェントのセッションに入ることはありません。harnsy Max のキーで有効になります。
github-ciapi.github.com
Authorization: Bearer …a91f
Who may use it: acme-shop › shop-backendacme-shop › shop-qa
read only · /repos/acme/ · 60/min
openai-evalapi.openai.com
Authorization: Bearer …7c2e
Who may use it: acme-shop › shop-qa
キーは入れるだけで、取り出せません。
設定 › キー(「キーを追加」)で、名前とキーの送り先にできるホストを指定してキーを追加します。その後、ダッシュボードに表示されるのは末尾4文字だけです。エージェントは、あなたのキーではなく自分の席のトークンを使って、harnsy 経由でサービスを呼び出します。
指定したホストにだけ。
1つのキーに登録できるホストは最大8つです。キーはそのホストへのリクエストにだけ付き、他のホストには付きません。localhost のようなプライベートアドレスは登録できません。リクエストは https://<ホスト> に送られ、別のポートを指定しない限りポート443を使います。harnsy はリダイレクトを追いません。キーをヘッダーに入れるかクエリに入れるか、どの形式にするかは、あなたが選びます。
誰がどこまで使えるか。
キーを提供するプロジェクトとロールは、あなたが選びます。使えるメソッドとパスを絞ったり、読み取り専用にしたり、1分あたりのリクエスト数に上限を付けたりできます。これは設定であって壁ではありません。このマシン上のエージェントは、ロールにヘルパーを座らせることができるので、そのアクセスを任せられるロールにだけキーを提供してください。
すべての呼び出しの記録。
エージェントがキーを使って行った呼び出しはすべて記録されます。ダッシュボードには、いつ、誰が、どのリクエスト(メソッドとパス)で、結果がどうだったかが、拒否された呼び出しも含めて表示されます。記録は90日間保存され、キーは含まれません。
届く範囲が見える GitHub トークン。
GitHub のトークンを接続として追加すると、harnsy はそのトークンが届くリポジトリと、それぞれが属するプロジェクトを一覧にします。きめ細かい権限のトークンは、コピーせずにキーとしてエージェントに渡せます。GitHub はトークンがワークフロー(.github/workflows)を変更できるかどうかを教えてくれないため、変更できないこと、またはエージェントに変更を許してよいことを、あなたが確認します。トークンがプロジェクトで使う以上のリポジトリを参照できる場合は、それらのプロジェクトのエージェントがすべてのリポジトリに届くことを、あなたが確認します。リポジトリや組織のシークレット、フック、Actions の権限を読めるトークンは、harnsy が拒否します。
差し替えも取り消しも1か所で。
キーに新しい値を入れても、すべてのエージェントはそのまま動きます。セッションや設定を変える必要はありません。キーを取り消すと、harnsy が持つコピーはすぐに消去され、記録のために行だけが残ります。キーそのものは、あなたがサービス側で取り消すまで、サービス上では使えるままです。
できないことも、正直に
- Keystore が隠すのはキーです。与えたアクセスでエージェントが何をするかは制限しません。メソッド、パス、読み取り専用、リクエスト頻度を設定してください。
- キーのホスト、ポート、付け方はあとから変更できません。新しいキーを作ってください。
- キーが送られるのは https://<ホスト> だけで、別のポート(1〜65535)を指定しない限りポート443です。リダイレクトは追わず、環境のプロキシも使いません。ホストは公開ホストに限られ、localhost やプライベートアドレスは使えません。
- 接続から作る GitHub のキーには、きめ細かい権限のトークンが必要です。クラシックトークンは使えません。
- キーは harnsy が動いているマシンに留まります。
最初のチームは、ひと言で始められます。
インストールはエージェントへのひと言で済みます。エージェントを代わりに開くため、harnsy は端末を操作します。Linux と macOS では tmux、Windows では独自の端末ホストです。
https://harnsy.dev/llms.txt の手順に従って harnsy をインストールして