Cómo funcionan los conectores
Conecte GitHub directamente; la IA de su Studio conecta el resto.
Los vinculan las herramientas de su equipo con su . Un puede leer de ellas, llevar datos a y enviar resultados de vuelta.
Dos formas de conectar
| GitHub (nativo) | Todos los demás (IA) | |
|---|---|---|
| Quién lo conecta | Un propietario o administrador del espacio de trabajo, una vez para todo el espacio | Cualquier persona que trabaje en un proyecto, con la IA de ese proyecto |
| Cómo | Instala la aplicación de Klarety en GitHub y elige repositorios | La IA prepara la conexión; usted la termina con su clave o inicio de sesión |
| Dónde se usa | Cada proyecto puede vincular uno de los repositorios elegidos | El proyecto donde se creó, más los proyectos que active un administrador |
La guía de GitHub cubre el conector nativo. Esta página cubre el flujo con IA.
Cómo conecta la IA un servicio
1. Usted lo pide
Abra un conector en Conectores y use Conéctelo con la IA de su Studio: elija un Proyecto, revise Lo que se le pide a la IA y seleccione Enviar a la IA. O, dentro de un proyecto, vaya a Configuración, luego Claves, y use Pedir a la IA que conecte.
from klarety import Nexus
nx = Nexus.connect("YOUR_API_KEY")
nx.service_connections.ask_ai("PROJECT_ID", "Connect Stripe so it can read payments")2. La IA prepara la conexión
La IA averigua el sitio, el tipo de clave y cómo obtenerla. El borrador no tiene clave, no llega a ninguna parte y aparece como Esperando su respuesta.
La IA nunca pide una clave en el chat
Nunca pegue una clave en un chat. Las claves van solo en el diálogo de conexión.
3. Usted la termina
Seleccione Conectar. El diálogo le pide una de:
- una Clave, con un enlace a la página donde obtenerla;
- un Nombre de usuario y una Contraseña, para bases de datos;
- un inicio de sesión con el proveedor, para servicios como Google y Microsoft.
Elija Qué puede hacer la IA con ello: Puede leer o Puede leer y modificar. Luego seleccione Conectar, Probar y Avisar a la IA.
4. El proyecto la usa
El llama al servicio y la clave se agrega en el camino de salida. La clave nunca entra al Studio.
Qué protege sus claves
- Selladas al instante. Se cifran con un servicio de claves administrado en cuanto selecciona Conectar. Nadie, ni siquiera la IA, puede volver a leerlas.
- Un solo sitio. El diálogo muestra el único sitio al que se envía la clave. Si no es la dirección propia del servicio, Klarety lo advierte y le pide escribirla para confirmar.
- El acceso mínimo. Elija Puede leer y modificar solo cuando el trabajo lo necesite.
- Ajuste de internet. Un proyecto con internet Desactivado no puede usar conexiones. Con Solo permitidos, su Studio solo llega a sus conexiones y a los sitios que usted agregue.
Ver y administrar las conexiones
En un proyecto, abra Configuración y luego Claves. Cada conexión muestra Esperando su respuesta, Funciona, Requiere reconexión o En pausa, con Conectar o Reconectar, Probar, Pausar o Reanudar, Desactivar aquí y Quitar.
Propietarios y administradores también ven Sus conexiones en Conectores. Una conexión sigue desactivada para otros proyectos hasta que un administrador la active.
from klarety import Nexus
nx = Nexus.connect("YOUR_API_KEY")
listed = nx.service_connections.list("PROJECT_ID")
for connection in listed["connections"]:
print(connection["name"], connection["health"])
result = nx.service_connections.check("PROJECT_ID", "CONNECTION_ID")
print(result["result"], result["detail"])
nx.service_connections.change("CONNECTION_ID", paused=True)
nx.service_connections.switch("CONNECTION_ID", "OTHER_PROJECT_ID", on=True)health es waiting, works, needs_reconnecting o paused. check devuelve result como works, key_rejected, cannot_reach, internet_off o not_connected, con un detail legible, nunca la clave. org() lista las conexiones del espacio de trabajo y switch activa una para un proyecto (solo propietarios y administradores).
Webhooks
Un servicio puede llamar a su proyecto cuando algo ocurre. En Configuración, Claves, seleccione Agregar webhook, dele al servicio la dirección que muestra Klarety y pegue su secreto de firma. Klarety verifica cada llamada. Vea un ejemplo en la guía de Stripe.