Assistants V2
Visão Geral
Sistema de versionamento para assistentes de IA da Antonnia
A API Assistants V2 permite criar, editar e versionar assistentes de IA com controle completo de branches, drafts e histórico de versões. Funciona como um sistema de controle de versão (similar ao Git) para a configuração dos seus assistentes.
Como funciona
Um assistente é composto por nodes (etapas do fluxo), tools (ferramentas que a IA pode usar), variables (variáveis de sessão) e context (nome e descrição). Todas essas peças são versionadas juntas.
┌─────────────┐ editar ┌───────┐ publicar ┌────────┐
│ Assistente │ ──────────────► │ Draft │ ─────────────► │ Commit │
│ │ │ │ │ │
└─────────────┘ └───────┘ └────────┘
│ │
│ criar branch │
▼ ▼
┌─────────────┐ ┌────────────┐
│ Branch │ ── cada branch tem seu draft ────────► │ Histórico │
└─────────────┘ └────────────┘- Crie um assistente — automaticamente cria uma branch
main - Edite o draft da branch — adicione nodes, tools, variables e configure o context
- Publique — o draft vira um commit imutável no histórico
- Runtime — o orquestrador lê a versão publicada mais recente da
main
Estrutura de um assistente
| Componente | Descrição | Path no versionamento |
|---|---|---|
| Context | Nome e descrição do assistente | context |
| Config | Configuração do grafo (node inicial) | config |
| Nodes | Etapas do fluxo conversacional | nodes/{id} |
| Tools | Ferramentas disponíveis para a IA | tools/{id} |
| Variables | Variáveis de sessão configuráveis | variables/{id} |
Base URL
https://services.antonnia.com/assistants/api/v2