ACI.DEV: Integration von mehr als 600 Tools für KI-Intelligenzen über MCP-Server

Allgemeine Einführung

ACI.dev ist eine Open-Source-Infrastrukturplattform, die KI-Intelligenzen eine schnelle Integration in über 600 Tools ermöglicht. Sie stellt sicher, dass Intelligenzen über eine mandantenfähige Authentifizierung und eine fein abgestufte Rechteverwaltung sicheren Zugriff auf Tools wie Google Calendar, Slack und Brave Search haben. Entwickler können auf Tools wie Google Calendar, Slack und Brave Search über direkte Funktionsaufrufe oder vereinheitlichte MCP ACI.dev bietet ein Python-SDK und eine ausführliche Dokumentation, um die schnelle Entwicklung von KI-Intelligenzen zu unterstützen, die sofort in Produktionsumgebungen funktionieren.

Funktionsliste

• Integration mit über 600 Tools und Unterstützung für Dienste wie Google Calendar, Slack, Brave Search und mehr.
• Unterstützt die mandantenfähige Authentifizierung, verwaltet Entwickler- und Benutzerrechte und gewährleistet die Datensicherheit.
• Bietet einen einheitlichen MCP-Server zur Vereinfachung der Werkzeugsuche und -ausführung.
• Unterstützt direkte Funktionsaufrufe und passt sich an eine Vielzahl von KI-Intelligenz-Frameworks an.
• Python-SDK für Entwickler zum Aufrufen der ACI-API.
• Unterstützt die dynamische Werkzeugsuche, bei der die Intelligenz auf der Grundlage der Aufgabenstellung automatisch Werkzeuge auswählen kann.
• Bietet OAuth2- und API-Schlüssel-Authentifizierung zur Vereinfachung des Autorisierungsprozesses für Tools von Drittanbietern.
• Unterstützung für natürlichsprachliche Genehmigungsgrenzen zur Erhöhung der Zuverlässigkeit der Intelligenz.
• Open-Source-Community-Unterstützung, die es Benutzern ermöglicht, Anfragen zur Tool-Integration einzureichen oder Code beizusteuern.
• Eine ausführliche Dokumentation und ein Beispielcode unterstützen den schnellen Einstieg.

Hilfe verwenden

Installation und Konfiguration

ACI.dev ist ein Open-Source-Projekt, das auf GitHub gehostet wird. Entwickler können die ACI-Funktionalität integrieren, indem sie die gesamte Plattform lokal bereitstellen (einschließlich des Back-End-Servers und des Front-End-Portals) oder das Python-SDK verwenden. Hier sind die detaillierten Installations- und Nutzungsschritte:

1. lokale Bereitstellung der ACI.dev-Plattform

Führen Sie die folgenden Schritte aus, um den ACI.dev-Backend-Server und das Front-End-Portal auszuführen:

• Klonen der Codebasis: Führen Sie den folgenden Befehl im Terminal aus, um den ACI-Quellcode zu erhalten:

  git clone https://github.com/aipotheosis-labs/aci.git
  cd aci

• Installation von AbhängigkeitenACI verwendet Python 3.12+ und Docker. Stellen Sie sicher, dass Docker und Docker Compose installiert sind. backend Verzeichnis, installieren Sie die Abhängigkeiten:

  cd backend
  uv sync
  source .venv/bin/activate
  

  ausnutzen uv Der Paketmanager installiert die Abhängigkeiten. Wenn die uvausgeführt werden kann:

  pip install uv
  

• Umgebungsvariablen konfigurierenKopieren Sie die Beispiel-Umgebungsvariablendatei und ändern Sie sie:

  cp .env.example .env.local
  

  existieren .env.local Die folgenden Schlüsselvariablen werden in der

  • SERVER_OPENAI_API_KEY: OpenAI API-Schlüssel für Smartbody-Aufrufe.
  • CLI_OPENAI_API_KEY: Der gleiche wie der Serverschlüssel oder ein anderer.
  • Wenn Sie die Stripe-Abrechnungsfunktion verwenden, führen Sie die Stripe-CLI aus, um den Webhook-Signierschlüssel zu erhalten:

    stripe listen --forward-to localhost:8000/v1/billing/webhook
    

    Setzen Sie den Ausgang des SERVER_STRIPE_WEBHOOK_SIGNING_SECRET hinzufügen .env.local.

• Neue DiensteStarten Sie das Backend und Frontend mit Docker Compose:

  docker-compose up
  

  Die Back-End-APIs werden standardmäßig in der localhost:8000Das Front-End-Portal läuft auf localhost:3000.

• Zugang zum Front-End-PortalIm Browser öffnen http://localhost:3000registrieren Sie sich für ein Konto. Nach der Registrierung erstellt das System automatisch Testprojekte und Intelligenzen, und Entwickler können Werkzeuge und Berechtigungen über das Portal verwalten.

2. das Python SDK verwenden

Wenn Sie die ACI-Funktionen nur über Code aufrufen möchten, können Sie das Python-SDK verwenden:

• Installieren des SDK::

  pip install aci-python-sdk
  

• Initialisierung des SDK::

  from aci import ACI
  import os
  client = ACI(api_key=os.environ.get("ACI_API_KEY"))
  

  ACI_API_KEY Verfügbar auf der ACI.dev-Plattform (http://localhost:3000) wird den Projekteinstellungen entnommen.

• Beispiel: Suche nach verfügbaren Werkzeugen::

  apps = client.apps.search(intent="搜索网页", allowed_apps_only=False)
  print(apps)  # 返回与意图相关的工具列表
  

• Beispiel: Funktionen des Ausführungswerkzeugs::

  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. die Verwendung des Unified MCP-Servers

Der MCP-Server ist die Kernkomponente von ACI.dev und bietet zwei Modi: Application Server und Unified Server:

• Anwendungsserver: Direkter Zugriff auf das angegebene Tool. Starten Sie zum Beispiel die Anwendungsserver für Brave Search und Gmail:

  uvx aci-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id user123
  

• einheitlicher ServerDynamische Erkennung und Ausführung aller ACI-Tools:

  uvx aci-mcp unified-server --linked-account-owner-id user123 --allowed-apps-only
  

  Der Unified Server bietet zwei Meta-Funktionen:ACI_SEARCH_FUNCTIONS(Suchwerkzeug) und ACI_EXECUTE_FUNCTION(Execution Tool), wodurch der Platzbedarf des LLM-Kontextfensters verringert wird.

• Kontoverknüpfungen konfigurierenBevor Sie das Tool nutzen können, müssen Sie Ihr Konto auf der ACI.dev-Plattform verknüpfen. Verknüpfen Sie zum Beispiel 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"
  )
  

  Bei Tools, die OAuth2 erfordern (z. B. Gmail), gibt das SDK die Autorisierungs-URL zurück, und der Benutzer muss die Autorisierung im Browser abschließen.

4. die Bedienung von Sonderfunktionen

• Dynamische WerkzeugsucheUnified MCP Server: Der Unified MCP Server unterstützt die automatische Auswahl von Werkzeugen durch Intelligenzen auf der Grundlage der Aufgabenstellung. Beispielcode:

  from aci.meta_functions import ACISearchFunctions
  tools = [ACISearchFunctions.to_json_schema(format="OPENAI")]
  

  Intelligente Körper können weitergegeben werden ACI_SEARCH_FUNCTIONS Abfrage aufgabenbezogener Werkzeuge.

• Multi-Tenant-ZertifizierungEntwickler können separate Berechtigungen für verschiedene Benutzer festlegen. Zum Beispiel können Sie Intelligenzen darauf beschränken, nur das Brave Search-Konto eines bestimmten Benutzers zu verwenden:

  client.functions.execute(
  function_name="BRAVE_SEARCH__WEB_SEARCH",
  linked_account_owner_id="user123",
  allowed_apps_only=True
  )
  

• Grenze der natürlichen SprachkompetenzACI.dev unterstützt die Definition von Berechtigungen in natürlicher Sprache. Zum Beispiel wird die Beschränkung eines intelligenten Benutzers auf "Kalender lesen" und nicht auf "Kalender ändern" über das Front-End-Portal oder SDK konfiguriert:

  client.permissions.set(
  agent_id="agent123",
  boundaries={"calendar": ["read"]}
  )
  

• Beiträge der GemeinschaftEntwickler können Anfragen für neue Tool-Integrationen einreichen oder direkt über GitHub Code beisteuern. Referenzen CONTRIBUTING.md im Gesang antworten Integration Request Template::

  gh issue create --title "New Integration: Twitter API" --body-file integration_request.yml
  

5. den Zugang zu Dokumentation und Beispielen

• offizielles Dokument: Zugang https://aci.dev/docs Hier finden Sie detaillierte API-Referenzen und Tutorials.
• Werkzeugliste: Ansicht https://aci.dev/tools Erfahren Sie mehr über die mehr als 600 unterstützten Tools.
• Beispielhafte Projekte: Referenz https://github.com/aipotheosis-labs/aci-agents Holen Sie sich ein Beispiel für eine intelligente Körperentwicklung.

caveat

• sicher .env.local Die API-Schlüssel in der Datei
• Für die lokale Entwicklung können Sie DBeaver verwenden, um sich mit der Datenbank zu verbinden (Parameter in der Datei .env.local), sehen Sie sich die Datenstruktur an.
• Das Python SDK befindet sich in der Beta-Phase und kann inkompatible Updates enthalten. Wir empfehlen daher, die Versionshinweise im GitHub-Repository zu beachten.
• Bei einigen Tools (z. B. Brave Search) müssen die Nutzer ihre eigenen API-Schlüssel bereitstellen, wofür möglicherweise Gebühren von Dritten anfallen.

Anwendungsszenario

1. Persönlicher Assistent Chatbot
   Verwenden Sie ACI.dev, um KI-Assistenten zu erstellen, die das Web durchsuchen, Kalender verwalten und E-Mails versenden. Die mandantenfähige Authentifizierung gewährleistet die Isolierung von Kontodaten zwischen verschiedenen Nutzern, um die persönliche Produktivität zu steigern.
2. Forschung Intelligenz
   Entwickler können ACI.dev verwenden, um Brave Search und Notion zu integrieren, um eine Intelligenz zu entwickeln, die automatisch Forschungsmaterial sucht und organisiert, das für akademische Forschung oder Marktanalysen geeignet ist.
3. Vertriebsautomatisierung
   ACI.dev unterstützt die CRM- und Gmail-Integration und ermöglicht Entwicklern die Erstellung von Vertriebsinformationen, die automatisch Listen mit potenziellen Kunden erstellen und E-Mails zur Verbesserung der Geschäftseffizienz versenden.
4. Intelligente Kundenbetreuung
   Integrieren Sie Zendesk und Slack mit ACI.dev, um Intelligenz zu schaffen, die automatisch auf Kundenanfragen reagiert und Arbeitsaufträge für den Kundendienst von Unternehmen verwaltet.
5. Zusammenarbeit mit der Open-Source-Gemeinschaft
   Der Open-Source-Charakter von ACI.dev ermutigt Entwickler, neue Tool-Integrationen beizusteuern, um das Ökosystem der Plattform zu verbessern. Fügen Sie zum Beispiel die Twitter-API hinzu, um die Funktionalität von Intelligenzen zu erweitern.

QA

1. Welche Programmiersprachen werden von ACI.dev unterstützt?
   Hauptsächlich unterstützen Python, durch die Python SDK, um die API aufrufen. andere Sprachen können durch die REST-API zugegriffen werden, müssen ihre eigenen HTTP-Anfrage zu implementieren.
2. Wie kann ich eine neue Werkzeugintegration hinzufügen?
   Um auf die GitHub-Repositories zuzugreifen, siehe CONTRIBUTING.md im Gesang antworten Integration Request TemplateSie können Anfragen zur Tool-Integration stellen oder direkt Code beisteuern.
3. Was sind die Vorteile eines einheitlichen MCP-Servers?
   passieren (eine Rechnung oder Inspektion etc.) ACI_SEARCH_FUNCTIONS im Gesang antworten ACI_EXECUTE_FUNCTION Zwei Meta-Funktionen zur Vereinheitlichung der Verwaltung von mehr als 600 Tools, zur Verringerung der Belegung von LLM-Kontextfenstern und zur Verbesserung der Effizienz von Intelligenz.
4. Muss ich für jedes Tool eine separate Authentifizierung konfigurieren?
   Nein. ACI.dev bietet eine einheitliche, mandantenfähige Authentifizierung, bei der Entwickler einfach Konten in der Plattform verknüpfen und Intelligenzen sicher auf das Tool zugreifen können.
5. Erhebt ACI.dev eine Gebühr?
   ACI.dev ist eine Open-Source-Plattform und kann kostenlos genutzt werden. Für einige Tools müssen die Nutzer ihre eigenen API-Schlüssel bereitstellen, was mit Gebühren von Dritten verbunden sein kann.
6. Wie kann ich sicherstellen, dass mein Smart Body sicher ist?
   ACI.dev bietet eine fein abgestufte Berechtigungsverwaltung und natürlichsprachliche Berechtigungsgrenzen, die es Entwicklern ermöglichen, den Funktionsumfang von Intelligenzen über das Front-End-Portal oder SDK festzulegen.