Dovednosti
Co umí vaše AI, zabalené.
Veřejné API má pro dovednosti sedm metod. API dovednost stále nazývá AI agent, proto je to název v každé metodě. Působí na dovednosti, které už existují: připnou jednu, označí ji jako oblíbenou, archivují ji, vytvoří pro ni obrázek a zaznamenají souhlas. Každá jedná za účet, jehož klíč API použijete.
Vytvoření dovednosti, její naplánování z vašich slov, změna jejích pokynů nebo nástrojů, klonování, instalace z tržiště, výpis, sdílení, obnovení z archivu, smazání a volba tarifu se dělají v dashboardu. Dnes pro ně neexistuje veřejná metoda.
Pošlete požadavek metodě se svým klíčem:
Dobrá odpověď má code 1. Odmítnutá má záporný code a v data říká proč.
Každá metoda bere id dovednosti jako agent_id, což je poslední část adresy dovednosti v dashboardu. Kromě set_agent_tool_consent bere každá také volitelné workspace_id, aby jednala v jiném pracovním prostoru než ve vašem domovském. Ten pracovní prostor musíte vlastnit.
Připnutí a označení jako oblíbené
pin_ai_agentaunpin_ai_agentdovednost připnou a připnutí odeberou. Dashboard se to dozví okamžitě, takže otevřená stránka změnu ukáže.favorite_ai_agentaunfavorite_ai_agentnastaví a zruší značku oblíbené, srdce na kartě dovednosti. Oblíbené je také to, co vypisuje volba Oblíbené v nabídce Zobrazit.
Archivace
archive_ai_agent přesune dovednost z aktivního seznamu do Archivováno. Archivovaná dovednost se už nepočítá do počtu, který tarif pracovního prostoru pojme, takže je to způsob, jak udělat místo pod limitem.
- Dovednost může archivovat jen ten, kdo ji vytvořil. Pro kohokoli jiného je odpovědí odmítnutí, které říká, že operace není povolena.
- Dovednost, kterou jste sdíleli s jinými, se odmítne, dokud je sdílení aktivní. Nejdřív sdílení ukončete.
conversation_idje volitelné. S ním se archivuje jen ta jedna konverzace dovednosti. Bez něj se archivují všechny konverzace dovednosti spolu s ní.
Vrácení dovednosti nebo její trvalé smazání se dělá v dashboardu, ze zobrazení Archivováno.
Vytvoření obrázku
generate_ai_agent_image vytvoří nový obrázek pro jednu dovednost, kterou vlastníte, a uloží jej k dovednosti. Použijte jej, když dovednost nemá obrázek a její karta spadne na zástupný. Běží na pozadí, takže nový obrázek se objeví při příštím načtení dovednosti. Je to totéž jako Vygenerovat obrázek v nabídce karty.
Povolení nainstalované dovednosti používat nástroje jejího vydavatele
set_agent_tool_consent zaznamenává, zda nainstalované dovednosti povolujete používat nástroje pluginů, které běží v pracovním prostoru jejího vydavatele. Cokoli tyto nástroje vytvoří, se ukládá na disk vydavatele, ne na váš. Bere agent_id a granted, true pro povolení a false pro odvolání, a volitelně owner_uid, účet vydavatele. Zaznamenává vždy jen vaše vlastní rozhodnutí, nikdy cizí.
Dovednosti se počítají podle tarifu pracovního prostoru, ve kterém jsou. Co se počítá a co se děje na limitu, najdete v Tarifech a fakturaci.