Assistants IA
Des assistants qui répondent pour vous, en privé ou en public.
Assistants IA a six méthodes publiques. Elles agissent sur un assistant qui existe déjà : la marque de favori, l'épinglage, l'archivage et son image. Chacune agit pour le compte dont vous utilisez la clé API.
Créer un assistant, modifier sa configuration, ses préréglages et ses invitations, envoyer une invitation, lire ses sessions et choisir un forfait se font dans le tableau de bord. Ils n'ont aucune méthode publique aujourd'hui.
Envoyez une requête à une méthode avec votre clé :
Une bonne réponse a code 1. Une réponse refusée a un code négatif et dit pourquoi dans data. Voir Appeler une méthode pour les formes de requête.
Les listes Assistant et Compétence partagent ces méthodes, donc le champ s'appelle agent_id : c'est l'identifiant de l'assistant. Chaque méthode accepte aussi un workspace_id facultatif, pour agir dans un espace de travail autre que le vôtre. L'appelant doit le posséder.
Marquer un assistant
favorite_ai_agentprendagent_idet marque l'assistant comme favori. C'est le cœur sur sa carte, et le choix Favoris du menu Afficher de la page le liste.unfavorite_ai_agentprend le même champ et retire la marque.pin_ai_agentprendagent_idet marque l'assistant comme épinglé.unpin_ai_agentprend le même champ et retire l'épingle.
Archiver un assistant
archive_ai_agent prend agent_id et archive l'assistant. Il quitte la liste Actif et apparaît sous Archivé, et ses conversations sont archivées avec lui. Un conversation_id facultatif limite les conversations archivées à celle-là.
Seul le créateur de l'assistant peut l'archiver. Un assistant qui a été partagé avec vous est refusé avec Operation not allowed. Un assistant que vous avez partagé avec d'autres est refusé avec active share found jusqu'à la fin du partage.
Restaurer un assistant archivé et le supprimer définitivement sont des actions du tableau de bord : Désarchiver et Supprimer dans le menu de la carte, sous le statut Archivé.
Dessiner une image
generate_ai_agent_image prend agent_id et dessine une nouvelle image pour un assistant que vous possédez, avec le générateur qui s'exécute à la création d'un assistant. Utilisez-la quand une carte affiche l'image de remplacement. Elle s'exécute en arrière-plan comme une tâche, et la nouvelle image apparaît au chargement suivant.
Les choix de l'image, comme le pays, le genre, le secteur et vos propres mots, l'utilisation de votre propre portrait et une image importée se définissent dans la fenêtre de configuration du tableau de bord.
Ce que chaque forfait change
Aucune de ces méthodes n'est réservée à un forfait. Ce qu'un forfait change, c'est ce que l'assistant peut faire pour les visiteurs, ce qui n'est pas accessible par une méthode. Voir Forfaits et facturation.