はじめに
ACI.devは、AIインテリジェンスに600以上のツールへの迅速な統合を提供するために設計されたオープンソースのインフラストラクチャプラットフォームです。マルチテナント認証ときめ細かな権限管理により、インテリジェンスがGoogleカレンダー、Slack、Brave Searchなどのツールに安全にアクセスできることを保証します。開発者は、直接関数を呼び出すか、ユニファイド関数を使用してGoogleカレンダー、Slack、Brave Searchなどのツールにアクセスできます。 エムシーピー ACI.devはPython SDKと詳細なドキュメントを提供し、本番環境ですぐに動作するAIインテリジェンスの迅速な開発をサポートします。
機能一覧
- 600以上のツールと統合し、Googleカレンダー、Slack、Brave Searchなどのサービスをサポート。
- マルチテナント認証をサポートし、開発者とユーザーの権限を管理し、データのセキュリティを確保します。
- ツールの検索と実行を簡素化する統合MCPサーバーを提供。
- 関数の直接呼び出しをサポートし、さまざまなAIインテリジェンスフレームワークに適応。
- 開発者がACI APIを呼び出すためのPython SDKを提供する。
- タスクの意図に基づいてインテリジェンスが自動的にツールを選択できる、動的なツール発見をサポート。
- OAuth2とAPIキー認証を提供し、サードパーティツールの認証プロセスを簡素化します。
- インテリゲンチャの信頼性を高めるための自然言語許可境界のサポート。
- オープンソースコミュニティのサポートにより、ユーザーはツール統合のリクエストやコードの提供を行うことができます。
- クイックスタートをサポートするために、詳細なドキュメントとサンプルコードが提供されています。
ヘルプの使用
インストールと設定
ACI.devはGitHubでホストされているオープンソースプロジェクトです。開発者はACIの機能を統合するために、フルプラットフォーム（バックエンドサーバーとフロントエンドポータルを含む）をローカルにデプロイするか、Python SDKを使用することができます。以下はインストールと使用方法の詳細です：
1.ACI.devプラットフォームのローカル展開
ACI.dev バックエンドサーバーとフロントエンドポータルを実行するには、以下の手順に従います：
- コードベースのクローンターミナルで以下のコマンドを実行し、ACIのソースコードを取得する：
git clone https://github.com/aipotheosis-labs/aci.git cd aci
- 依存関係のインストールACIはPython 3.12+とDockerを使用します。DockerとDocker Composeがインストールされていることを確認してください。
backendディレクトリに依存関係をインストールする：cd backend uv sync source .venv/bin/activate利用する
uvPackage Managerは依存関係をインストールする。もしuvを実行することができる：pip install uv - 環境変数の設定サンプルの環境変数ファイルをコピーして修正する：
cp .env.example .env.localある
.env.local以下の主要変数はSERVER_OPENAI_API_KEYスマートボディ呼び出し用のOpenAI APIキー。CLI_OPENAI_API_KEYサーバーキーと同じか、別のキー。- Stripeの課金機能を使用する場合は、Stripe CLIを実行してWebhook署名キーを取得します：
stripe listen --forward-to localhost:8000/v1/billing/webhookの出力を設定する。
SERVER_STRIPE_WEBHOOK_SIGNING_SECRET追加する.env.local.
- サービス開始Docker Composeを使ってバックエンドとフロントエンドを起動します：
docker-compose upバックエンドAPIはデフォルトで
localhost:8000フロントエンド・ポータルはlocalhost:3000. - フロントエンド・ポータルへのアクセスブラウザで開く
http://localhost:3000をクリックし、アカウントを登録します。登録後、システムは自動的にテストプロジェクトとインテリジェンスを作成し、開発者はポータルを通じてツールと権限を管理できます。
2.PythonSDKを使う
コードを通してACIの機能を呼び出すだけなら、Python SDKを使うことができる：
- SDKのインストール::
pip install aci-python-sdk - SDKの初期化::
from aci import ACI import os client = ACI(api_key=os.environ.get("ACI_API_KEY"))ACI_API_KEYACI.devプラットフォーム(http://localhost:3000)はプロジェクト設定から取得される。 - 例：使用可能なツールの検索::
apps = client.apps.search(intent="搜索网页", allowed_apps_only=False) print(apps) # 返回与意图相关的工具列表 - 例：実行ツールの機能::
result = client.functions.execute( function_name="BRAVE_SEARCH__WEB_SEARCH", function_parameters={"query": {"q": "北京天气"}}, linked_account_owner_id="user123" ) if result.success: print(result.data) else: print(result.error)
3.統合MCPサーバーの使用
MCPサーバーはACI.devのコア・コンポーネントで、アプリケーション・サーバーとユニファイド・サーバーの2つのモードを提供する：
- アプリケーションサーバー指定したツールに直接アクセスできます。例えば、Brave SearchやGmailのアプリケーションサーバーを起動する：
uvx aci-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id user123 - ユニファイドサーバーすべてのACIツールの動的な検出と実行：
uvx aci-mcp unified-server --linked-account-owner-id user123 --allowed-apps-onlyユニファイドサーバーは2つのメタ機能を提供する：
ACI_SEARCH_FUNCTIONS(検索ツール）とACI_EXECUTE_FUNCTION(実行ツール）、LLMコンテキストウィンドウのフットプリントを削減します。 - アカウントリンクの設定: ツールを使用する前に、ACI.devプラットフォームでアカウントをリンクする必要があります。例えば、Brave Searchをリンクします：
result = client.linked_accounts.link( app_name="BRAVE_SEARCH", linked_account_owner_id="user123", security_scheme="API_KEY", api_key="your-brave-api-key" )OAuth2を必要とするツール（Gmailなど）の場合、SDKは認証URLを返し、ユーザーはブラウザで認証を完了する。
4.特別な機能の操作
- ダイナミック・ツール・ディスカバリー: Unified MCP Serverは、タスクの意図に基づいたインテリジェンスによる自動ツール選択をサポートします。サンプルコード
from aci.meta_functions import ACISearchFunctions tools = [ACISearchFunctions.to_json_schema(format="OPENAI")]インテリジェント・ボディはパスできる
ACI_SEARCH_FUNCTIONSタスク関連のツールを問い合わせる。 - マルチテナント認証開発者は、ユーザーごとに別々のパーミッションを設定できます。例えば、特定のユーザーのBrave Searchアカウントのみを使用するようにインテリジェンスを制限することができます：
client.functions.execute( function_name="BRAVE_SEARCH__WEB_SEARCH", linked_account_owner_id="user123", allowed_apps_only=True ) - 自然言語の権限境界ACI.dev は、自然言語によるパーミッションの定義をサポートしています。例えば、Intelligentが "read calendar "のみに制限され、"modify calendar "には制限されないことは、フロントエンドポータルまたはSDKを通して設定されます：
client.permissions.set( agent_id="agent123", boundaries={"calendar": ["read"]} ) - 地域貢献開発者は、新しいツール統合のリクエストを提出したり、GitHubを介して直接コードを貢献することができます。参考文献
CONTRIBUTING.md歌で応えるIntegration Request Template::gh issue create --title "New Integration: Twitter API" --body-file integration_request.yml
5.ドキュメントと実例へのアクセス
- 公文書アクセス
https://aci.dev/docs詳細なAPIリファレンスとチュートリアルを取得します。 - ツールリストを見る
https://aci.dev/tools対応する600以上のツールについてご紹介します。 - サンプルプロジェクト参考
https://github.com/aipotheosis-labs/aci-agents知的な身体づくりの例を手に入れよう。
ほら
- セキュア
.env.localAPIキーは - ローカルで開発する場合、DBeaver を使ってデータベースに接続することができます (パラメータは
.env.local)、データ構造を見る。 - Python SDKはベータ版であり、互換性のないアップデートが行われる可能性があるため、GitHubリポジトリのリリースノートに従うことをお勧めします。
- 一部のツール（Brave Searchなど）では、ユーザーが独自のAPIキーを提供する必要があり、これにはサードパーティの料金が発生する場合があります。
アプリケーションシナリオ
- パーソナル・アシスタント・チャットボット
ACI.devを使用して、ウェブ検索、カレンダー管理、メール送信を行うAIアシスタントを構築します。マルチテナント認証は、個人の生産性を向上させるために、異なるユーザー間でアカウントデータの分離を保証します。 - リサーチ・インテリジェンス
開発者はACI.devを使ってBrave SearchとNotionを統合し、学術研究や市場分析に適した研究資料を自動的に検索・整理するインテリジェンスを構築することができる。 - セールスオートメーション
ACI.devはCRMとGmailの統合をサポートしており、開発者は見込み客リストを自動的に生成し、業務効率を向上させるメールを送信するセールスインテリジェンスを構築することができる。 - カスタマーサポート・インテリジェンス
ZendeskとSlackをACI.devと統合することで、顧客からの問い合わせに自動的に対応し、企業のカスタマーサービスで作業指示を管理するインテリジェンスを構築できます。 - オープンソースコミュニティのコラボレーション
ACI.devのオープンソースの性質は、開発者がプラットフォームのエコシステムを改善するために新しいツールの統合を貢献することを奨励しています。例えば、インテリジェンスの機能を拡張するためにTwitter APIを追加する。
品質保証
- ACI.devはどのプログラミング言語をサポートしていますか？
主にPythonをサポートし、Python SDKを介してAPIを呼び出します。他の言語は、REST APIを介してアクセスすることができ、独自のHTTPリクエストを実装する必要があります。 - 新しいツール統合を追加するには？
GitHubリポジトリにアクセスするには、以下を参照してください。CONTRIBUTING.md歌で応えるIntegration Request Templateまた、ツール統合のリクエストを提出したり、直接コードを提供することもできます。 - 統合MCPサーバーの利点は何ですか？
とおすACI_SEARCH_FUNCTIONS歌で応えるACI_EXECUTE_FUNCTION600以上のツールの管理を一元化し、LLMのコンテキスト・ウィンドウの占有率を下げ、インテリゲンチャの効率を向上させる2つのメタ機能。 - ツールごとに認証を設定する必要がありますか？
ACI.devは統一されたマルチテナント認証を提供し、開発者はプラットフォームにアカウントをリンクするだけで、インテリジェンスは安全にツールにアクセスできる。 - ACI.devは有料ですか？
ACI.devはオープンソースのプラットフォームであり、無料でご利用いただけます。一部のツールでは、ユーザーが独自のAPIキーを提供する必要があり、サードパーティの料金が発生する場合があります。 - スマートボディの安全性を確認するには？
ACI.devは、きめ細かな権限管理と自然言語による権限境界を提供し、開発者がフロントエンドのポータルやSDKを通じてインテリジェンスの操作範囲を設定できるようにします。
日本語 
简体中文 
English 
Deutsch 
Português do Brasil