AI-assistenten
Assistenten die namens jou antwoorden, privé of openbaar.
AI-assistenten heeft zes publieke methoden. Ze werken op een assistent die al bestaat: de favorietmarkering, de pin, het archief en zijn afbeelding. Elke methode werkt voor het account waarvan je de API-sleutel gebruikt.
Een assistent maken, zijn instelling, voorinstellingen en uitnodigingen wijzigen, een uitnodiging versturen, zijn sessies lezen en een abonnement kiezen doe je in het dashboard. Daar is op dit moment geen publieke methode voor.
Stuur een verzoek naar een methode met je sleutel:
Een goed antwoord heeft code 1. Een geweigerd antwoord heeft een negatieve code en zegt in data waarom. Zie Een methode aanroepen voor de vormen van het verzoek.
De lijsten Assistenten en Vaardigheden delen deze methoden, dus het veld heet agent_id: het is de id van de assistent. Elke methode neemt ook een optionele workspace_id, om in een andere werkruimte dan je eigen te werken. De aanroeper moet die bezitten.
Een assistent markeren
favorite_ai_agentneemtagent_iden markeert de assistent als favoriet. Dit is het hartje op zijn kaart, en de keuze Favorieten in het menu Tonen van de pagina toont hem.unfavorite_ai_agentneemt hetzelfde veld en haalt de markering weg.pin_ai_agentneemtagent_iden markeert de assistent als vastgezet.unpin_ai_agentneemt hetzelfde veld en haalt de pin weg.
Een assistent archiveren
archive_ai_agent neemt agent_id en archiveert de assistent. Hij verdwijnt uit de lijst Actief en staat onder Gearchiveerd, en zijn gesprekken worden mee gearchiveerd. Een optionele conversation_id beperkt de gearchiveerde gesprekken tot dat ene.
Alleen de maker van de assistent kan hem archiveren. Een assistent die met jou is gedeeld, wordt geweigerd met Operation not allowed. Een assistent die je met anderen hebt gedeeld, wordt geweigerd met active share found totdat de deling eindigt.
Een gearchiveerde assistent terugzetten en definitief verwijderen zijn acties in het dashboard: Uit archief halen en Verwijderen in het menu van de kaart, onder de status Gearchiveerd.
Een afbeelding tekenen
generate_ai_agent_image neemt agent_id en tekent een nieuwe afbeelding voor een assistent die je bezit, met de generator die draait als er een wordt gemaakt. Gebruik het als een kaart de plaatsaanduiding toont. Het draait op de achtergrond als taak, en de nieuwe afbeelding verschijnt bij de volgende keer laden.
De keuzes voor de afbeelding, zoals land, geslacht, branche en je eigen woorden, het gebruik van je eigen portret en een geüploade afbeelding stel je in het instelvenster van het dashboard in.
Wat elk abonnement verandert
Geen van deze methoden wordt door een abonnement beperkt. Wat een abonnement verandert, is wat de assistent voor bezoekers kan doen, en dat is niet bereikbaar via een methode. Zie Abonnementen en facturering.