Vai al contenuto principale

Panoramica

Apollo Brain è l’assistente AI centrale — un agente conversazionale alimentato da Claude che può leggere e modificare l’intero workspace. Non è un semplice chatbot; dispone di oltre 160 strumenti nativi organizzati in 18 categorie con un sistema di routing basato sulle competenze.

Come Accedere

Apollo Brain è disponibile da qualsiasi pagina tramite un pulsante flottante nell’angolo in basso a destra. Cliccalo per aprire il pannello Brain con due schede: Chat e Voice.

Interfaccia Chat

La scheda chat offre un’esperienza completa da agente:
  • Risposte in streaming — visualizza il ragionamento dell’AI in tempo reale tramite SSE (Server-Sent Events)
  • Esecuzione strumenti — osserva Brain mentre chiama strumenti per interrogare database, creare attività, analizzare codice
  • Pannelli di contesto — pannelli laterali mostrano le attività/progetti/risorse referenziati
  • Human-in-the-Loop (HITL) — per qualsiasi operazione di scrittura (creare, aggiornare, eliminare), Brain chiede la tua conferma prima di eseguire
  • Persistenza sessione — le conversazioni vengono salvate e possono essere riprese
  • Titoli auto-generati — le sessioni ricevono titoli significativi basati sul contenuto della conversazione

Architettura dell’Agente

Routing Basato sulle Competenze

Ogni messaggio viene indirizzato a 4 competenze specializzate:
CompetenzaDominioEsempi di Query
project_managementAttività, progetti, release, sprint, epic, team”Elenca tutte le attività in ritardo nel Progetto Alpha”
code_devopsGitHub, deploy, infrastruttura, CI/CD”Mostra i commit recenti sul branch main”
personalNote, attività personali, obiettivi, promemoria”Crea un promemoria per il mio 1:1 domani alle 15”
generalistTutto il resto — analisi, consigli, conoscenza generale”Come dovrei strutturare questa API?”

Sistema di Memoria

Apollo Brain utilizza un sistema di memoria a 3 livelli:
  1. Memoria di Sessione — contesto all’interno della conversazione corrente
  2. Memoria Episodica — riassunti delle conversazioni passate memorizzati in agent_sessions
  3. Memoria Procedurale — pattern appresi e preferenze utente in agent_procedural_memory

Precaricamento del Contesto

Ad ogni messaggio, Brain alimenta una cache calda DuckDB con i dati del tuo workspace e costruisce uno snapshot markdown del tuo stato attuale (progetti attivi, attività recenti, membri del team) che viene iniettato nel system prompt. Questo fornisce a Brain una consapevolezza istantanea del tuo workspace senza dover effettuare query.

Categorie di Strumenti

list_tasks, create_task, update_task, get_task_details, search_tasks, create_tasks_bulk, bulk_assign_tasks, bulk_update_task_status, bulk_update_estimated_hours, create_task_dependency, delete_task_dependency, add_task_comment, list_task_comments
list_projects, get_project_status, export_project_data
list_releases, create_release, get_release_details, update_release, assign_tasks_to_release
Note: search_personal_notes, list_personal_notes, get_personal_note, create_personal_note, update_personal_note, list_personal_foldersAttività: list_personal_tasks, create_personal_task, update_personal_task, delete_personal_taskObiettivi: list_personal_goals, create_personal_goal, update_personal_goal_progressPromemoria: list_personal_reminders, create_personal_reminder, complete_personal_reminder, snooze_personal_reminder, update_personal_reminder, dismiss_personal_reminder, delete_personal_reminder
Lettura: list_connected_repos, get_task_commits, get_task_prs, search_commits, get_repo_activityScrittura: analyze_pr_changes, suggest_reviewers, check_merge_readiness, create_pr_review, create_branch, merge_pull_request
ECS: list_ecs_clusters, list_ecs_services, get_ecs_service_details, force_deploy_ecs_service, scale_ecs_service, get_ecs_service_logsLambda: list_lambda_functions, invoke_lambda_function, get_lambda_logsECR: list_ecr_repositories, get_ecr_scan_resultsCI/CD: list_github_workflows, trigger_github_workflowTerraform: list_terraform_states, detect_terraform_driftCosti: get_infrastructure_costs, get_cost_forecast, get_infrastructure_overviewDeploy: list_deployments, get_amplify_build_status, trigger_amplify_deploy
list_conversations, get_conversation_messages, search_chat_messages, send_chat_message, get_unread_summary, list_notifications, mark_notifications_read, get_user_presence, add_message_reaction, mark_conversation_read
search_knowledge_base, get_kb_page, list_kb_pages, list_kb_folders, create_kb_page, update_kb_page, delete_kb_page
Team: list_team_members, get_user_by_nameTracciamento Tempo: list_time_entries, log_time, get_active_timer, start_timer, stop_timer, get_time_summaryCarico di Lavoro: get_workload_summary, get_time_off, get_weekly_goals, analyze_workload_balanceCode Intelligence: diagnose_error, suggest_fix, get_recent_changes, analyze_repository_structure, read_file_contentsPSE: get_pse_session_status, start_spec_generation, answer_pse_clarification

Human-in-the-Loop (HITL)

Per sicurezza, tutte le operazioni di scrittura (creare, aggiornare, eliminare) richiedono la conferma dell’utente prima dell’esecuzione. Quando Brain vuole eseguire una modifica:
  1. Brain ti mostra cosa vuole fare (es.: “Vorrei creare un’attività con questi dettagli…”)
  2. Appare un pannello di conferma con i pulsanti Approva e Rifiuta
  3. Rivedi l’azione e decidi
  4. Solo dopo l’approvazione lo strumento viene eseguito
Le operazioni di lettura (elencare, cercare, ottenere) vengono eseguite automaticamente senza conferma.