Un connector permet a ONE accedir a una eina que es troba fora de Factorial IT. Afegeix-ne un quan vulguis que l'assistent busqui informació o realitzi accions en un altre sistema que el teu equip ja utilitza.

Funcionalitat

Visió general

Cada connector és un servidor del Model Context Protocol (MCP) que registris mitjançant la seva URL. Quan està connectat, ONE pot trucar a les eines que ofereix aquest servidor mentre xateges amb ell. Per exemple, pot trobar una pàgina a Notion o dur a terme una tasca en un altre servei.

Raons típiques per afegir-ne un:

• Buscar dades en un altre lloc. Aporta informació que té una eina de la qual el teu equip depèn.
• Actuar en un altre lloc. Permet que l'assistent completi tasques dins d'un servei connectat.
• Ampliar el que pot fer l'assistent. Connecta qualsevol eina que sigui compatible amb el Model Context Protocol.

No necessites un connector si l'assistent només ha de treballar amb dades de Factorial IT o amb les directrius pròpies de la teva empresa. Per això, utilitza articles de la base de coneixements.

Abans de començar

• Per afegir, editar, re-autenticar o eliminar connectors, o per canviar les seves permisos d'eina, necessites el permís de Gestionar agents d'IA. Per veure'ls, és suficient el permís de Veure agents d'IA.
• Necessites la URL d'un servidor MCP que suporti l'autenticació OAuth.

Com utilitzar

1. Vés a Agents d'IA > Configuració i selecciona la pestanya Connectors.
2. Fes clic a Afegeix connector. S'obre una finestra.
3. Omple els detalls:
   • Nom: com es nomena el connector, per exemple Notion.
   • URL del servidor: l'endpoint MCP, per exemple https://example.com/mcp.
4. Obre Configuració avançada només si el teu servidor MCP no suporta la Registre dinàmic de clients. En aquest cas, registra Factorial IT a la consola OAuth del proveïdor i introdueix l'ID de client i el secret de client. Els clients públics que depenen de PKCE poden deixar el secret en blanc.
5. Fes clic a Connectar. Se't redirigeix al servidor MCP per iniciar sessió. Un cop concedeixis accés, tornes a Factorial IT i el connector mostra Connectat.

Estats del connector

Veure un connector

La pestanya Connectors mostra primer els connectors integrats (Factorial IT i el connector del centre d'ajuda), seguit de qualsevol que hagis afegit. Els connectors integrats estan sempre Connectats. Fes clic a qualsevol connector per obrir la seva pàgina.

En la pàgina d'un connector que has afegit trobaràs:

• Configuració: el Nom, la URL del servidor i, si n'has introduït un, el ID de client. El secret de client mai es mostra. Utilitza Edita connexió per canviar aquests valors. Canviar la URL del servidor o les credencials OAuth significa que has d'autenticar-te de nou.
• Permisos de xat i Permisos d'agent: cada eina que ofereix el servidor MCP, cadascuna amb la seva política. Veure "Estableix permisos d'eina" a continuació.

La llista d'eines es recupera del servidor MCP cada vegada que obres la pàgina, així que sempre coincideix amb el que el servidor ofereix actualment. Les eines només es mostren mentre el connector està Connectat. Si el servidor no respon, veuràs un avís en comptes de les eines, i Configuració continuarà sent utilitzable.

Els connectors integrats no tenen Configuració ni menú Accions. No pots editar-los ni eliminar-los, però pots canviar els seus permisos d'eina.

Gestionar un connector

En la pàgina d'un connector que has afegit, utilitza el menú Accions a la part superior dreta:

• Re-autenticar: inicia sessió al servidor MCP de nou. Aquesta opció només apareix quan el connector no està Connectat.
• Eliminar: elimina el connector juntament amb les seves credencials desades, un cop ho confirmis. Si un agent està utilitzant el connector, no el podràs eliminar fins que el desactives en aquell agent.

Estableix permisos d'eina

La pàgina del connector controla com ONE pot utilitzar cada eina. Quan el connector està Connectat, les seves eines es classifiquen en dues seccions:

• Permisos de xat cobreixen les teves pròpies converses amb ONE.
• Permisos d'agent cobreixen ONE quan treballa sense supervisió, per exemple en un tiquet on l'has afegit com a agent. Quan activis el connector per a un agent personalitzat, aquest agent pren una còpia d'aquestes configuracions i les manté. Els canvis realitzats aquí després no arriben a aquell agent.

Ambdues seccions agruparan les eines en Eines de només lectura i Eines de lectura-escriptura. Una eina es considera de només lectura només si el servidor MCP la marca amb l'anotació readOnlyHint. Qualsevol altra cosa es tracta com a lectura-escriptura.

Per establir una política per a tot un grup, utilitza el menú a la dreta d'aquest grup. L'elecció també s'aplica a les eines que el servidor afegeix en el futur, i substitueix qualsevol configuració eina per eina en el grup. Per establir una eina, expandeix el grup i tria una política amb les icones al costat del nom de l'eina. Quan les eines d'un grup tenen polítiques mixtes, el grup mostra Personalitzat.

Polítiques per defecte, fins que les canviïs:

Això significa que els agents poden utilitzar eines de lectura-escriptura immediatament. Per mantenir els agents limitats a llegir en un connector, estableix Eines de lectura-escriptura a Rebutjar sempre sota Permisos d'agent. Qualsevol agent personalitzat que ja estigui utilitzant el connector té la seva pròpia còpia, així que actualitza-ho també en aquell agent.

Com ONE utilitza connectors

Durant una conversa, ONE té accés a les eines de cada connector connectat i tria la correcta per a cada sol·licitud. Per dirigir-lo cap a un connector en particular, escriu @ a la caixa de missatges i selecciona el connector. ONE comprova els Permisos de xat del connector abans d'executar qualsevol eina. Per defecte, et pregunta abans d'utilitzar una eina que escrigui o canviï dades.

Solució de problemes i FAQ

Solució de problemes

• El connector mostra Error. La connexió ha fallat. Obre la seva pàgina i utilitza Accions > Re-autenticar.
• El connector roman en Pendent d'autenticació. L'autenticació no s'ha acabat. Re-autentica i completa l'inici de sessió al servidor MCP.
• No apareixen eines a la pàgina del connector. Les eines només es mostren mentre el connector està Connectat, i el servidor ha de respondre. Si veus un avís, el servidor no ha respost.
• No pots eliminar un connector. Un agent encara l'està utilitzant. Desactiva'l en aquell agent primer.
• La connexió falla en un servidor sense Registre dinàmic de clients. Registra Factorial IT a la consola OAuth del proveïdor i introdueix l'ID de client i el secret de client sota Configuració avançada.
• Un canvi de permís no ha arribat a un agent. L'agent manté la seva pròpia còpia. Canvia la política dins de l'agent.

FAQ

1. Quin permís necessito per afegir un connector?
   Gestionar agents d'IA. Veure agents d'IA només et permet veure connectors.
    
2. Puc editar o eliminar els connectors integrats?
   No. Només pots canviar els seus permisos d'eina.
    
3. Com decideix Factorial IT si una eina és de només lectura?
   Només les eines que el servidor MCP marca amb readOnlyHint són de només lectura. Qualsevol altra eina és de lectura-escriptura.
    
4. Per què no hi ha cap Requerir aprovació per als agents?
   Un agent funciona per compte propi, així que ningú hi és per aprovar l'eina.
    
5. Puc veure el secret de client després de desar-lo?
   No. Mai es torna a mostrar.