HN 日本語サマリー

← 一覧へ戻る
ビジネス・スタートアップ

CRM: オープンソース、エージェントファーストCRM

CRM: An open-source, agentic-first CRM (github.com)

10 pointsby handfuloflight5 コメント

要約

このCRMは、従来のデータベース中心のアプローチとは異なり、「エージェント」を最優先する設計が特徴です。エージェントは自律的にタスクをこなし、情報を収集・整理し、人間が介入する必要のある部分のみを提示します。これにより、人間はより重要な業務に集中でき、データの一貫性と信頼性を高めることを目指しています。

全文翻訳

CRM

[画像: Powered by Context]

[画像: stars]

Comp AI CRMは、AIエージェントのために設計されたオープンソースのCRMです。
エージェントファーストなCRM。

エージェント · スタック · クイックスタート · 設定 · デプロイ · コントリビューション

[画像: MIT licence] [画像: Built with eve] [画像: Built with Bun] [画像: Postgres]

[画像: エージェントタブでアカウントが開いている企業リスト]


これは何か

ほとんどのCRMは、その前にフォームがあるデータベースです。AI搭載のCRMは、そのフォームの横にチャットボックスを追加します。どちらも、真実を見つけ出し、それを書き留めるという実際の作業を、より良い用事がある人間に任せてしまいます。

これは逆の方法で構築されています。エージェントはCRMの機能ではなく、CRMはエージェントがメモを保管する場所です。 独自のデプロイメントで、独自のスケジュールで、独自のワークキューに対して実行されます。次に何を見るかを決定し、自身のフォローアップを予約し、リサーチ予算を使い、予算が尽きたら停止します。リクエスト・レスポンスの要素は何もありません。ブラウザを閉じても実行し続けます。

エージェント自身が決して破らないルール:人のことについて推測しないこと。 どのツールも信頼度スコアを受け入れません。なぜなら、自身の確実性を評価するように求められたモデルはそうし、有用に見える方向に間違えるからです。ツールは観察したことを報告します — crm.signature-block、github.account-identity — そして台帳がその証拠に価格をつけます。強力な証拠は記録に書き込まれます。弱い証拠は、人間が判断する提案になります。顧客に関する自信に満ちた誤った事実は、空欄よりも悪いのです。なぜなら、誰もそれが間違っていると気づけないからです。

スクリーンショット

エージェント

apps/agent は、Vercelの永続的なエージェントのためのファイルシステムファーストフレームワークであるeve上に構築された、独自のデプロイメントです。ツールはファイル、スキルはMarkdownファイル、スケジュールはファイルであり、ランタイムが永続的な部分(再デプロイ後も存続するセッション、停止した場所から再開する作業)を処理します。

18個の作成済みツールread_crm_history、search_crm、identify_contact、research_person、enrich_company、record_fact、schedule_recheck…
4つのスキルevidence.md、identity-matching.md、data-boundaries.md、writing-a-brief.md — エージェントが読む文章、コードのようにバージョン管理される
1つのスケジュールdispatch.ts、これは何も決定しません。期限切れの行をリースし、行ごとにセッションを開始します。
サンドボックスbash、grep、glob、および/workspace、deny-all egress付き

それは自己実行します。 lib/tasks.tsはワークキューです:claimDueはFOR UPDATE SKIP LOCKEDで期限切れの行をリースするため、2つのディスパッチャーは互いに排他的な作業を行い、実行中のものが終了するとリースが期限切れになったときにその行を解放します。「N分ごとに、最も古い10件の連絡先」のようなものは、cron式ではなく、タスクのdueAtに属します。エージェントが誰かに再度連絡したい場合、schedule_recheckを呼び出して理由を伝えます。そしてその理由は担当者に表示されます。なぜ14日後に戻るのかを説明できないエージェントは理由を持っているのではなく、デフォルトを持っているだけです。

すべての外部ソースはオプションであり、それらがなくても動作するように設計されています。 APIキーが全くなくても動作します:read_crm_historyはあなた自身のスレッド、会議、署名ブロックを読み取ります。これは無料であり、最高の証拠です — どのデータベンダーも、その人物自身のメールアドレスからの返信を販売することはできません。各キーは、さらに1つの場所を開きます。インストールされているキーのリストが各セッションの開始時に伝えられるため、失敗した呼び出しごとにギャップを発見するのではなく、実際に持っているものに基づいて計画を立てます。そして、起動時にリストを表示します。

[agent] off  Web research (PERPLEXITY_API_KEY)
[agent] on   Company brand data (Settings → General)
[agent] on   LinkedIn (Settings → General)

会社ブランドデータとLinkedInはどちらもContextから取得され、どちらも同じキーから提供されます。前者はロゴ、色、業界、ドメインの背後にある実際の名前であり、アカウントがそれ自体として到着するのと、イニシャルが入ったグレーの正方形として到着するのと違いを生み出します。後者は、そのレコードに既にあるLinkedIn URLから人物を読み取ります — その人物の実際の名前、現在の役職、雇用主、および以前のすべての役職 — これは、アドレスが誰に属するかを決定するものです。これは、設定されるのではなく要求される唯一のキーです:行に存在し、オンボーディングで要求され、その後Settings → Generalで変更されます。なぜなら、セルフホスターの管理者は環境変数を設定するために再デプロイできないからです。

サンドボックスにはネットワークもデータベースもありません。 これをオンにすると、モデルにシェルが提供されます — ツール呼び出し機能と、記録を保持し、先月からのプロファイルを今月と比較し、スレッドを署名ブロックでgrepできるものの違いです。deny-all egressは無料です。なぜなら、web_fetchはアプリのランタイムで実行され、web_searchはモデルプロバイダーで実行されるからです。削除されるのは、顧客のメール本文がシェルコマンドを通じて流出する唯一の経路です。そのルールのもう半分は不在です:サンドボックスには決してDATABASE_URLが与えられません。 認証情報とエグレスを持つシェルは、内部ツールであっても流出の形をしていますが、どちらも持たないシェルはテキストプロセッサです。

対話でき、その作業を見守ることができます。 すべての連絡先、会社、取引にはAgentタブがあります — それが実行するステップ、それが却下するリードとその理由、そして2人の人物の間で決定できない場合にその場で回答された質問です。会話は永続的で、リロード後も存続します。レコードはメッセージの先頭に固定されるのではなく、署名付きトークンで転送されます。両方のプロセスでAGENT_BRIDGE_SECRETを同じ値に設定して有効にします。それがない場合、タブは設定されていないと報告し、エージェントは自身のスケジュールを実行し続けます。

docs/agent.mdが完全な説明です。

スタック

Bun上のTurborepoモノレポ、Vercelにデプロイ。

エージェントeve — 永続セッション、ツール、スキル、スケジュール、サンドボックス
モデルVercel AI Gateway — プロバイダーSDKなし、Vercel上のOIDCによりキー管理不要
サンドボックス本番環境ではVercel Sandbox、ローカルではDockerまたはmicrosandbox
フロントエンドNext.js App Router · shadcn/ui · URL状態管理のためのnuqs
APInestjs-trpc搭載NestJS — HTTP、認証、tRPC、メールボックス同期
データPrisma · Postgres (Neon) · オプションRedis (Upstash)
認証Better Auth — Google、Microsoft、または独自のIdP;1つの許可リスト
ファイルVercel Blob — プロファイル写真をミラーリングし、ソースが消えても存続させる
ツールBiome · すべてTypeScript

アプリはtRPC経由でAPIと通信し、ルーター型はNestJSルーターから生成されるため、フロントエンドはPrismaの行からテーブルセルまで型安全です。リストの状態(フィルター、ソート、ページ)はURLに存在するため、アドレスバーをコピーするとビューが再現されます。

レイアウト
パス
apps/agentリサーチエージェント — ツール、スキル、スケジュール、サンドボックス
apps/appNext.jsフロントエンド · :3000
apps/apiNestJS API — HTTP、認証、tRPC、メールボックス同期 · :3001
packages/dbPrismaスキーマ、マイグレーション、共有Postgresクライアント
packages/authBetter Auth設定とサインイン許可リスト
packages/uishadcn/uiコンポーネント、Tailwindテーマ
packages/envルート.envを検索してロードする
コードベースが守る3つのルール

スタイルガイドではなく、作業が行われる場所で記述されています。

  • インテリジェンスはAPIに存在しない (docs/api.md)。Nestは何かが発生したことを報告し、エージェントがその意味を決定します。アイデンティティマッチングの2つのコピーが、一方が地球上のすべての雇用主と一致するまで、かつてはずれがありました。
  • packages/uiのみがUIのソースである (docs/design.md)。呼び出しサイトでのスタイルのオーバーライドはありません。
  • 組織は存在しない。 シングルテナント、意図的です。常に同じ値を持つorganizationIdは、列、インデックス、および権限チェックであり、何も購入せず、レビュー時には実際のもののようによみます。

クイックスタート

BunとDockerが必要です。

git clone https://github.com/trycompai/crm.git && cd crm
cp .env.example .env          # 次に以下の値を入力
bun install

docker compose up -d          # Postgres on :5432

bun run db:deploy             # マイグレーションを適用
bun run db:seed               # オプション:信頼できるパイプラインを表示用に追加
bun run dev

アプリはlocalhost:3000、APIはlocalhost:3001で利用可能です。

そのクローンは、デフォルトブランチであり最後のタグ付きリリースであるreleaseを提供します。これは、これを実行している場合に必要です。mainは未リリースの作業が着地する場所です:グリーンですが、まだカットされていません。プルリクエストを送信するためにここにいる場合は、まずgit switch mainを実行し、CONTRIBUTINGを読んでください。

設定する値

.envを開き、これらを設定します。ファイル内の他のすべてはオプションであり、コメントアウトされています。

変数値
BETTER_AUTH_SECRETopenssl rand -base64 32
ALLOWED_SIGN_INあなたのメールドメイン、例: acme.com。または1つのアドレス、例: you@gmail.com。
GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRETGoogle OAuthクライアント — 2分、下記。両方またはどちらもなし。
MICROSOFT_CLIENT_ID / MICROSOFT_CLIENT_SECRETMicrosoft Entraアプリ登録 — 下記。両方またはどちらもなし。

GoogleとMicrosoftの少なくとも1つを選択するか、ログイン後にSettings → SSOで独自のIDプロバイダーを追加してください。両方設定しても問題ありませんし、一般的です:サインインページは両方のボタンを提供し、各担当者のメールはサインインした方から読み取られます。

DATABASE_URLは既にdocker compose Postgresと一致しているため、独自のものを持ち込まない限りそのままにしておいてください。

Google OAuthクライアントの取得

  1. Google Cloudコンソール → Credentials → Create credentials → OAuth client ID → Web application。
  2. Authorised redirect URIsの下に、http://localhost:3001/api/auth/callback/googleを追加します。
  3. プロジェクトでGmail APIとCalendar APIを有効にします。
  4. クライアントIDとシークレットを.envにコピーします。

Googleはクローンが開始するサインイン方法であり、同じクライアントがGmailとCalendarを読み取るため、ほとんどのインストールで必要とされます。しかし、APIはそれなしでも起動します:Microsoftまたは独自のIDプロバイダー(Settings → SSOで追加)でサインインするインストールは、両方を空にしてGoogleボタンやGmail同期を取得しません。ペアで設定するか、全く設定しないかのどちらかです。不完全なペアは、Googleで失敗するボタンになります。アカウントがGoogle Workspaceドメインにある場合、同意画面をInternalに設定すると、組織外の誰もプロンプトに到達できません。

Microsoftアプリ登録の取得

  1. Azureポータル → Microsoft Entra ID → App registrations → New registration。Microsoft自身のウォークスルーはRegister an applicationです。
  2. Supported account typesの下で、サインインする全員がテナントにいる場合はAccounts in this organizational directory onlyを選択します。それより広い範囲でも構いません — ALLOWED_SIGN_INは誰がアカウントを取得するかを決定します — しかし、狭い選択肢は外部者をMicrosoft側で、当社のドアではなく、拒否します。
  3. Redirect URIをWebに設定し、http://localhost:3001/api/auth/callback/microsoftとします。本番環境ではhttps://<your-api-host>/api/auth/callback/microsoftとなります — アプリのオリジンではなくAPIのオリジンです。なぜならAPIが/api/auth/*を提供しているからです。
  4. API permissions → Add a permission → Microsoft Graph → Delegated permissions → User.ReadとMail.Readをチェックします。offline_accessはサインイン時に要求され、ここにエントリは必要ありません。テナントが管理者の同意を必要とする場合は、担当者がそれぞれ尋ねられないようにGrant admin consentをクリックします。
  5. Certificates & secrets → New client secret。Secret IDではなくValueをコピーします — 値は一度だけ表示され、二度と表示されません。
  6. Overview → Application (client) IDをコピーします。
  7. これら2つを.envにMICROSOFT_CLIENT_IDとMICROSOFT_CLIENT_SECRETとして入力します。

Mail.Readは読み取り専用です:CRMはメッセージを一覧表示して読み取ることができますが、送信、返信、移動、削除はできません。読み取りは前方のみです — 最初のチェックで現在の時刻が記録され、何もインポートされないため、古いメールボックスを接続しても数年分のメールがCRMにダンプされることはありません。

Microsoft側で他のテナントを拒否するためにALLOWED_SIGN_INに依存する代わりに、テナントのGUID(Overview → Directory (tenant) ID)をMICROSOFT_TENANT_IDに設定します。デフォルトはcommonで、あらゆる仕事、学校、または個人用Microsoftアカウントを受け入れ、許可リストでそれらをソートします。organizationsは中間設定です:仕事または学校のアカウントのみ、個人用アカウントは不可。

Microsoftクライアントシークレットは期限切れになります — 最大24ヶ月、デフォルトで6ヶ月です。期限切れをどこかにメモしてください。なぜなら、期限切れの症状は、すべての担当者のメールが静かに同期に失敗することだからです。

ALLOWED_SIGN_INは、認証モデル全体です — 未設定の値は誰もサインインできないことを意味し、これは安全な失敗方向です。全体ドメイン、個々のアドレス、またはそれらの混合を受け入れます:

ALLOWED_SIGN_IN="acme.com"                       # あなたの会社の全員
ALLOWED_SIGN_IN="acme.com,contractor@gmail.com"  # …プラス外部の1人
ALLOWED_SIGN_IN="you@gmail.com"                  # 1人用のインストール

設定

.envはリポジトリのルートに1つだけあり、3つのプロセスすべてによって読み取られます。実際の環境変数が常に優先されるため、ホスティングプラットフォームではそこで設定し、ファイルはローカルの便宜のためだけのものです。

上記の値以外はすべてオプションであり、アプリはそれなしでも動作します。.env.exampleは、各項目に注釈付きの完全なリストです。短いバージョンは以下の通りです:

API_URL / APP_URL両方の部分が提供される場所。localhost以外でのみ必要です。
PERPLEXITY_API_KEYエージェントが引用付きでオープンウェブを検索できるようにします。
AGENT_BRIDGE_SECRET担当者が連絡先のAgentタブからエージェントと対話できるようにします。
REDIS_URL共有キャッシュ。これがない場合、インスタンスごとでインメモリです。
CRON_SECRETメールボックス同期ルートを保護します。使用するには必要です。
CRM_TELEMETRY_DISABLED1に設定すると、このインストールは何も報告しません。DO_NOT_TRACKも同様です。

タスク

コマンド
bun run devローカルデータベースを準備し、依存関係を認識したウォッチモードで全てを実行します
bun run buildすべてのアプリとパッケージをビルドします
bun run testテストスイートを実行します
bun run check-typesすべてでtsc --noEmitを実行します
bun run lint / formatBiome
bun run db:migrateマイグレーションを作成して適用します
bun run db:seedデモパイプラインを補充します(冪等)
bun run db:studioPrisma Studio
bun run --filter=api trpc:generateAppRouter型を再生成します
bun run --filter=api dev:sessionローカルユーザーのセッションCookieを表示します

それらのいずれかのスコープをTurborepoフィルターで指定します:bun run dev --filter=api。

サインインはIDプロバイダーを経由するため、ターミナルからセッションを取得する方法はありません。dev:sessionはBetter Authが書き込むであろう行を書き込み、設定されるであろうCookieを表示します。NODE_ENV=productionでは実行を拒否します。

デプロイ

3つのデプロイメントと1つのPostgres:Next.jsアプリ、NestJS API、およびエージェント。これらは独立しており、唯一合意しなければならないのはDATABASE_URLとBETTER_AUTH_SECRETです — APIがセッションCookieを発行し、アプリがそれを検証するため、不一致はエラーではなくリダイレクトループになります。

API_URLとAPP_URLを実際のオリジンに設定し、両方が1つの親の異なるサブドメインにある場合は、AUTH_COOKIE_DOMAINを親に設定して1つのCookieで両方をカバーできるようにします。プロバイダーのリダイレクトURIにhttp://your-api-host/api/auth/callback/googleを追加します — そして、Microsoftを使用する場合はhttp://your-api-host/api/auth/callback/microsoftも追加します。CRON_SECRETを設定し、スケジューラーをPOST /internal/sync/mailboxesに向けます。これによりメールボックス同期が実行され続けます。

apps/api/src/generated/server.tsはコミットされており、buildはそれを再生成してはなりません — ジェネレーターはほとんどのビルドイメージよりも新しいGLIBCを必要とします。ローカルで再生成し、それが原因となったルーター変更とともにコミットしてください。

コントリビューション

エージェントが書いたプルリクエストよりも、あなたが書いた段落を歓迎します。CONTRIBUTING.mdを参照してください。

セキュリティ問題は、公開されたイシューではなく、SECURITY.mdを通じて、プライベートに処理されます。

ライセンス

MIT。