Handleidingen

Agents

De ingebouwde Nimbly Agent en het framework voor je eigen agents.

Nimbly bevat Nimbly Agent, een assistent die het framework en de huidige site kent, en een agentframework voor agents van je eigen project. Dit zijn mogelijkheden van de applicatie: agents kunnen meedoen aan gesprekken en vastgelegde workflows draaien via hetzelfde platform als de rest van je systeem.

Nimbly Agent

De ingebouwde agent helpt bevoegde gebruikers informatie te vinden, door de applicatie te navigeren en met content te werken. Zijn tools kunnen resources en documentatie van de site lezen, en records maken, wijzigen of verwijderen binnen de rechten van de gebruiker die het vraagt.

Context over de site voeg je toe in ext/agents/nimbly/project.md. Dat vult de ingebouwde instructies aan, terwijl updates van het framework de onderliggende definitie van de agent blijven leveren.

Beschikbaar maken voor gebruikers

De ingebouwde assistent heeft de instellingen nodig van de modelprovider die in zijn definitie staat, op dit moment OPENAI_API_KEY in de runtime-.env. Houd deze sleutel buiten gevolgde bestanden.

De chat en de agent moeten aan staan in de site-instellingen, en de rol van de gebruiker moet chat-nimbly geven. Een chatagent wordt beschikbaar als de vereiste omgevingsinstellingen, de schakelaars van de site en het recht van de rol er allemaal zijn. De core-HTML-layout bevat de knop voor de teamchat voor ingelogde gebruikers die toegang hebben.

Deze voorwaarden voor toegang staan los van de rechten voor handelingen op data. Een gebruiker toegang geven tot de chat geeft hem geen recht om een resource te bewerken.

Een gespecialiseerde agent definiëren

Een agent van het project staat in ext/agents/<agent-id>/. De agent.json ervan definieert identiteit, instructies, tools, uitvoeringslimieten en pipelines. De ingebouwde definitie in core/modules/agent/agents/nimbly/agent.json is een voorbeeld van een chatagent.

  • Een chat_pipeline maakt een agent beschikbaar in de teamchat.
  • Een pipeline definieert werk dat in de wachtrij, op schema of na een event draait.
  • Connectors van het project in ext/lib/agent-connector-<id>.php leveren het integratiegedrag dat tools en pipelinestappen gebruiken.

Een definitie in het project met dezelfde identiteit vervangt de core-definitie. Voeg context over de site toe als dat genoeg is; vervang de definitie als het gedrag anders moet zijn.

Tools, uitvoering en autorisatie

Agents gebruiken tools en connectors die vooraf zijn opgegeven. Bewaakte handelingen hebben een autorisatiestap vóór de uitvoering. De contenttools van Nimbly Agent handelen met de rechten van de gebruiker die het vraagt. Een eigen agent definieert de autorisatie die past bij wat hij echt doet, en gaat er niet van uit dat toegang tot een gesprek ook het recht geeft om iets uit te voeren.

Het framework legt runs, stappen, events en handelingen vast, zodat je kunt nagaan wat er draaide en met welk resultaat. Uitvoering via de wachtrij en op schema gebruikt de bestaande basis voor jobs en planning. Het project bepaalt zijn bedrijfslogica, tools, schema's en limieten.

Een studiosite kan bijvoorbeeld een assistent toevoegen die vragen over de projecten beantwoordt, of een geplande workflow die een wekelijks overzicht maakt. Het project bouwt de bijbehorende tools, rechten en het afleveren.

Verder lezen

Bekijk deze pagina als Markdown