Guida rapida: Team

Questa guida ti accompagna nella configurazione dell’accesso API per team e organizzazioni standard (non Enterprise). Creerai un utente di servizio, otterrai le tue credenziali ed effettuerai la tua prima chiamata API in pochi minuti.

Se fai parte di un account Enterprise con più organizzazioni, ruoli personalizzati o SSO, consulta invece la guida rapida Enterprise.

Passaggio 1: Crea un utente di servizio

Vai su Settings > Devin API nella tua organizzazione e apri il tab utenti di servizio
Fai clic su Provision utente di servizio
Scegli un nome visualizzato descrittivo (ad es. “CI Pipeline”, “Monitoring Bot”)
Seleziona un ruolo:
- Admin — accesso completo, incluse le impostazioni dell’organizzazione e la gestione dei membri
- Member — può creare e gestire sessioni Devin e la maggior parte delle risorse dell’organizzazione, ma non le impostazioni dell’organizzazione o la gestione dei membri

Usa il ruolo Member per la maggior parte dei casi di automazione. Usa Admin solo se la tua integrazione deve gestire le impostazioni dell’organizzazione o altri utenti.

Passaggio 2: Copia la tua API key

Dopo aver effettuato il provisioning dell’utente di servizio, la sua API key viene mostrata in una finestra di dialogo
Copia subito la chiave — inizia con cog_ e non verrà più mostrata
Conservala in modo sicuro come variabile di ambiente:

export DEVIN_API_KEY="cog_your_key_here"

Passaggio 3: Effettua la tua prima chiamata API

Crea una sessione Devin:

export DEVIN_ORG_ID="your_org_id"

curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Create a simple Python script that prints Hello World"}'

Trova l’ID della tua organizzazione in cima alla pagina Settings → Devin API.

Vuoi che le sessioni siano attribuite al tuo utente? Per impostazione predefinita, le sessioni sono attribuite all’utente di servizio. Per creare sessioni per conto di uno specifico utente (in modo che compaiano nell’elenco delle sessioni di quell’utente), aggiungi "create_as_user_id": "user_abc123" al corpo della richiesta. Questo richiede il ruolo Admin (che include l’autorizzazione ImpersonateOrgSessions). Consulta Session attribution per i dettagli.

Passaggio 4: Operazioni comuni

Elenca le sessioni

curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

Invia un messaggio a una sessione attiva

export SESSION_ID="your_session_id"

curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions/$SESSION_ID/messages" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Please also add unit tests"}'

Gestire Knowledge

# Elenca le voci di Knowledge
curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

# Crea una voce di Knowledge
curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Coding standards", "trigger": "When writing code", "body": "Use TypeScript strict mode..."}'

Autorizzazioni per gli utenti di Teams

Le organizzazioni di Teams hanno un modello di autorizzazioni semplice:

Ruolo	Può creare sessioni	Può gestire le risorse	Può gestire le impostazioni
Member	Sì	Sì (Knowledge, playbook, secret)	No
Admin	Sì	Sì	Sì

Per un controllo degli accessi basato sui ruoli (RBAC) più granulare, consulta la guida rapida Enterprise.

Prossimi passi

Esplora gli endpoint dell’Organization API nella barra laterale
Consulta i flussi comuni per i pattern di integrazione più comuni
Approfondisci l’autenticazione
Configura le automazioni pianificate per le attività ricorrenti

Introduzione

Concetti

Ciclo di vita dell'agente

Gestione del contesto

Gestione degli ambienti

Automazione

Integrazioni

Analytics

Osservabilità

Devin per la Sicurezza

Infrastruttura

Identità e accessi

Configurazione

API legacy v1

API legacy v2

Passaggio 1: Crea un utente di servizio

Passaggio 2: Copia la tua API key

Passaggio 3: Effettua la tua prima chiamata API

Passaggio 4: Operazioni comuni

Elenca le sessioni

Invia un messaggio a una sessione attiva

Gestire Knowledge

Autorizzazioni per gli utenti di Teams

Prossimi passi

​Passaggio 1: Crea un utente di servizio

​Passaggio 2: Copia la tua API key

​Passaggio 3: Effettua la tua prima chiamata API

​Passaggio 4: Operazioni comuni

​Elenca le sessioni

​Invia un messaggio a una sessione attiva

​Gestire Knowledge

​Autorizzazioni per gli utenti di Teams

​Prossimi passi

Passaggio 1: Crea un utente di servizio

Passaggio 2: Copia la tua API key

Passaggio 3: Effettua la tua prima chiamata API

Passaggio 4: Operazioni comuni

Elenca le sessioni

Invia un messaggio a una sessione attiva

Gestire Knowledge

Autorizzazioni per gli utenti di Teams

Prossimi passi