BuildShip

Integra CometAPI con i workflow di BuildShip usando il nodo CometAPI Text Generator, i trigger REST API e l’integrazione basata su chiave per la generazione di testo.

BuildShip è un builder visuale low-code per backend. Usa il nodo della community CometAPI Text Generator per aggiungere la generazione di testo basata su AI a qualsiasi workflow.

​

Prerequisiti

• Un account CometAPI con una chiave API attiva — ottieni la tua qui
• Un account BuildShip — accedi qui

1. Ottieni la tua chiave API CometAPI

   Accedi alla console CometAPI. Fai clic su Add API Key e copia la tua chiave sk-xxxxx.

   

   
2. Crea un workflow con un trigger REST API

   1. Nella dashboard di BuildShip, fai clic su Create a new workflow → From Scratch.
   2. Nel canvas, fai clic su Add Trigger e seleziona REST API. Questo genera un endpoint richiamabile per il workflow.
3. Aggiungi il nodo CometAPI Text Generator

   1. Sotto il trigger REST API, fai clic su + Add a new step.
   2. Nella casella di ricerca della libreria dei nodi, digita cometapi.
   3. Dall’elenco Community, seleziona CometAPI Text Generator.

   

   
4. Collega l'integrazione CometAPI

   Questo passaggio indica al nodo quale sistema di gestione delle chiavi utilizzare.

   1. Fai clic sul nodo per aprire il Node Editor sulla destra.
   2. Passa alla scheda Settings.
   3. In Key-based Integration, apri il menu a discesa e seleziona CometAPI.
   4. Fai clic sul pulsante blu Save nell’angolo in alto a destra.

   
5. Aggiungi la tua chiave API al nodo

   1. Nel Node Editor, passa alla scheda Inputs (oppure fai clic direttamente sul nodo).
   2. Fai clic sull’icona della chiave 🔑 nell’angolo in alto a destra del nodo per aprire il menu a discesa delle chiavi.
   3. Seleziona + Bring your own Key.
   4. Inserisci un Key ID (ad es. cometapi-key-1) e incolla la tua chiave sk-xxxxx in Value.
   5. Fai clic su Save.

   

   
6. Configura i parametri di input

   Nella scheda Inputs del nodo:

   • Instructions (opzionale): imposta un ruolo di sistema, ad es. You are a productivity assistant.
   • Prompt: fai clic sull’icona </>, quindi seleziona Trigger → Body → prompt per mappare il body della richiesta in ingresso.
   • Advanced → Model: inserisci l’ID del model corrente che vuoi utilizzare.

   
7. Aggiungi un nodo Return Response ed esegui il test

   1. Sotto il nodo CometAPI, fai clic su + Add a new step e seleziona Return Response.
   2. Nel campo Body, fai clic su </> e seleziona la variabile response dal nodo CometAPI Text Generator.
   3. Fai clic su Test nell’angolo in alto a destra, seleziona il formato di input JSON e invia:

   {
     "prompt": "hi"
   }
   

   4. Una risposta riuscita nel pannello Result conferma che il workflow funziona.

   

   Se la chiamata non riesce, verifica la tua chiave API e che Key-based Integration sia impostato su CometAPI, oppure contatta il supporto CometAPI.

Il passaggio Key-based Integration (collegare il nodo a CometAPI) è essenziale — saltarlo causerà errori di autenticazione anche se la tua chiave API è corretta.