ACI.DEV: integración de más de 600 herramientas de inteligencia artificial a través del servidor MCP

Introducción general

ACI.dev es una plataforma de infraestructura de código abierto diseñada para proporcionar a las inteligencias de IA una rápida integración con más de 600 herramientas. Garantiza que las inteligencias tengan acceso seguro a herramientas como Google Calendar, Slack y Brave Search a través de la autenticación multiusuario y la gestión detallada de permisos. MCP ACI.dev proporciona un SDK de Python y documentación detallada para apoyar el rápido desarrollo de inteligencias de IA que funcionen listas para usar en entornos de producción.

Lista de funciones

• Integración con más de 600 herramientas y compatibilidad con servicios como Google Calendar, Slack, Brave Search, etc.
• Admite la autenticación multiusuario, gestiona los derechos de desarrolladores y usuarios y garantiza la seguridad de los datos.
• Proporciona un servidor MCP unificado para simplificar la búsqueda y ejecución de herramientas.
• Admite llamadas directas a funciones y se adapta a diversos marcos de inteligencia artificial.
• Proporciona un SDK de Python para que los desarrolladores llamen a la API de ACI.
• Admite el descubrimiento dinámico de herramientas, en el que las inteligencias pueden seleccionar automáticamente las herramientas en función de la intención de la tarea.
• Proporciona autenticación OAuth2 y de clave API para simplificar el proceso de autorización de herramientas de terceros.
• Compatibilidad con los límites de permiso del lenguaje natural para mejorar la fiabilidad de la inteligencia.
• Apoyo comunitario de código abierto que permite a los usuarios enviar solicitudes de integración de herramientas o contribuir con código.
• Se proporciona documentación detallada y código de ejemplo para facilitar una rápida puesta en marcha.

Utilizar la ayuda

Instalación y configuración

ACI.dev es un proyecto de código abierto alojado en GitHub. Los desarrolladores pueden integrar la funcionalidad de ACI desplegando la plataforma completa de forma local (incluido el servidor back-end y el portal front-end) o utilizando el SDK de Python. A continuación se detallan los pasos de instalación y uso:

1. Despliegue local de la plataforma ACI.dev

Para ejecutar el servidor back-end y el portal front-end de ACI.dev, siga estos pasos:

• Clonación del código baseEjecute el siguiente comando en el terminal para obtener el código fuente de ACI:

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

• Instalación de dependenciasACI utiliza Python 3.12+ y Docker. asegúrese de que Docker y Docker Compose están instalados. vaya a backend instale las dependencias:

  cd backend
  uv sync
  source .venv/bin/activate
  

  utilizar uv El Gestor de paquetes instala las dependencias. Si el uvse puede ejecutar:

  pip install uv
  

• Configuración de variables de entorno: Copie el archivo de variables de entorno de ejemplo y modifíquelo:

  cp .env.example .env.local
  

  existe .env.local Las siguientes variables clave se establecen en el

  • SERVER_OPENAI_API_KEYClave API de OpenAI para llamadas smartbody.
  • CLI_OPENAI_API_KEY: La misma que la clave del servidor u otra.
  • Si utiliza la función de facturación de Stripe, ejecute la CLI de Stripe para obtener la clave de firma del webhook:

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

    Ajuste la salida del SERVER_STRIPE_WEBHOOK_SIGNING_SECRET añadir a .env.local.

• Inicio de los serviciosInicia el backend y el frontend usando Docker Compose:

  docker-compose up
  

  Las API de back-end se ejecutan por defecto en el directorio localhost:8000El portal se ejecuta en localhost:3000.

• Acceso al portalAbrir en el navegador http://localhost:3000Regístrese para obtener una cuenta. Tras el registro, el sistema crea automáticamente proyectos de prueba e inteligencias, y los desarrolladores pueden gestionar herramientas y permisos a través del portal.

2. Uso del SDK de Python

Si sólo desea invocar la funcionalidad de ACI mediante código, puede utilizar el SDK de Python:

• Instalación del SDK::

  pip install aci-python-sdk
  

• Inicialización del SDK::

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

  ACI_API_KEY Disponible en la plataforma ACI.dev (http://localhost:3000) se obtiene de la configuración del proyecto.

• Ejemplo: Búsqueda de herramientas disponibles::

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

• Ejemplo: Funciones de la herramienta de ejecución::

  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. Uso del servidor de Unified MCP

El servidor MCP es el componente central de ACI.dev y ofrece dos modos: servidor de aplicaciones y servidor unificado:

• servidor de aplicacionesAcceso directo a la herramienta especificada. Por ejemplo, inicie los servidores de aplicaciones para Brave Search y Gmail:

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

• servidor unificado: Descubrimiento dinámico y ejecución de todas las herramientas ACI:

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

  El Servidor Unificado ofrece dos metafunciones:ACI_SEARCH_FUNCTIONS(herramienta de búsqueda) y ACI_EXECUTE_FUNCTION(Herramienta de ejecución), lo que reduce la huella de la ventana contextual LLM.

• Configurar enlaces de cuentasAntes de utilizar la herramienta, debes vincular tu cuenta en la plataforma ACI.dev. Por ejemplo, vincula 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"
  )
  

  Para las herramientas que requieren OAuth2 (por ejemplo, Gmail), el SDK devuelve la URL de autorización y el usuario tiene que completar la autorización en el navegador.

4. Funcionamiento de las funciones especiales

• Descubrimiento dinámico de herramientasEl Servidor MCP Unificado soporta la selección automatizada de herramientas por inteligencias basadas en la intención de la tarea. Código de ejemplo:

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

  Los cuerpos inteligentes pueden pasar ACI_SEARCH_FUNCTIONS Consultar herramientas relacionadas con las tareas.

• Certificación multiinquilinoLos desarrolladores pueden establecer permisos separados para diferentes usuarios. Por ejemplo, restringir las inteligencias para que solo utilicen la cuenta de Brave Search de un usuario específico:

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

• Límite de autoridad del lenguaje naturalACI.dev permite definir permisos en lenguaje natural. Por ejemplo, restringir un Inteligente a sólo "leer calendario" y no "modificar calendario" se configura a través del portal front-end o SDK:

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

• Contribuciones comunitariasLos desarrolladores pueden enviar solicitudes de integración de nuevas herramientas o aportar código directamente a través de GitHub. Referencias CONTRIBUTING.md responder cantando Integration Request Template::

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

5. Acceso a documentación y ejemplos

• documento oficial: Acceso https://aci.dev/docs Obtenga referencias y tutoriales detallados sobre la API.
• Lista de herramientas: Ver https://aci.dev/tools Más información sobre las más de 600 herramientas compatibles.
• Ejemplos de proyectos: Referencia https://github.com/aipotheosis-labs/aci-agents Consigue un ejemplo de desarrollo corporal inteligente.

advertencia

• seguro .env.local Las claves API en el
• Para el desarrollo local, puede utilizar DBeaver para conectarse a la base de datos (parámetros en el archivo .env.local), ver la estructura de datos.
• El SDK de Python está en Beta y puede tener actualizaciones incompatibles, por lo que recomendamos seguir las notas de la versión en el repositorio de GitHub.
• Algunas herramientas (como Brave Search) requieren que los usuarios proporcionen sus propias claves API, lo que puede implicar el pago de tasas a terceros.

escenario de aplicación

1. Asistente personal Chatbot
   Utilice ACI.dev para crear asistentes de IA que busquen en Internet, gestionen calendarios y envíen correo electrónico. La autenticación multiusuario garantiza el aislamiento de los datos de la cuenta entre distintos usuarios para aumentar la productividad personal.
2. Investigación
   Los desarrolladores pueden utilizar ACI.dev para integrar Brave Search y Notion con el fin de crear inteligencia que busque y organice automáticamente material de investigación, adecuado para la investigación académica o el análisis de mercado.
3. automatización de ventas
   ACI.dev admite la integración de CRM y Gmail, lo que permite a los desarrolladores crear inteligencia de ventas que genere automáticamente listas de clientes potenciales y envíe correos electrónicos para mejorar la eficacia empresarial.
4. Inteligencia de atención al cliente
   Integre Zendesk y Slack con ACI.dev para construir inteligencias que respondan automáticamente a las consultas de los clientes y gestionen las órdenes de trabajo para el servicio de atención al cliente empresarial.
5. Colaboración de la comunidad de código abierto
   La naturaleza de código abierto de ACI.dev anima a los desarrolladores a contribuir con nuevas integraciones de herramientas para mejorar el ecosistema de la plataforma. Por ejemplo, añadir la API de Twitter para ampliar la funcionalidad de las inteligencias.

CONTROL DE CALIDAD

1. ¿Qué lenguajes de programación admite ACI.dev?
   Soporta principalmente Python, a través del SDK de Python para llamar a la API. otros idiomas se puede acceder a través de la API REST, necesidad de implementar su propia solicitud HTTP.
2. ¿Cómo añado una nueva integración de herramientas?
   Para acceder a los repositorios de GitHub, consulte CONTRIBUTING.md responder cantando Integration Request Template, envíe solicitudes de integración de herramientas o contribuya directamente con código.
3. ¿Cuáles son las ventajas de un servidor MCP unificado?
   aprobar (una factura o inspección, etc.) ACI_SEARCH_FUNCTIONS responder cantando ACI_EXECUTE_FUNCTION Dos metafunciones para unificar la gestión de más de 600 herramientas, reducir la ocupación de la ventana contextual de LLM y mejorar la eficacia de la inteligencia.
4. ¿Tengo que configurar una autenticación distinta para cada herramienta?
   No. ACI.dev proporciona autenticación multiusuario unificada, en la que los desarrolladores sólo tienen que vincular las cuentas en la plataforma y las inteligencias pueden acceder a la herramienta de forma segura.
5. ¿ACI.dev cobra alguna tasa?
   ACI.dev es una plataforma de código abierto y de uso gratuito. Algunas herramientas pueden requerir que los usuarios proporcionen sus propias claves API, lo que puede implicar el pago de tasas a terceros.
6. ¿Cómo puedo asegurarme de que el funcionamiento de mi smart body es seguro?
   ACI.dev proporciona una gestión de privilegios detallada y límites de privilegios en lenguaje natural, lo que permite a los desarrolladores establecer el ámbito de funcionamiento de las inteligencias a través del portal front-end o el SDK.