Conceitos
Estes são os objetos centrais do AgentHub. Entendê-los torna o restante da documentação muito mais simples.
| Conceito | Descrição |
|---|---|
| Ferramenta (Tool) | Uma API externa registrada na plataforma, com nome, descrição, endpoint e configuração de autenticação. A descrição é o que a IA usa para decidir quais agentes precisam da ferramenta. |
| Agente (Agent) | Uma entidade de IA com identidade própria (client_id / client_secret). Só chama ferramentas que foram explicitamente aprovadas para ele. |
| Solicitação de acesso (Access Request) | Um pedido pendente para que um agente use uma ferramenta específica. Criado automaticamente pela correspondência por IA quando um agente ou uma ferramenta é registrado. |
| Concessão de acesso (Agent Tool) | Um vínculo ativo e com prazo entre um agente e uma ferramenta. Quando expira, bloqueia a execução. |
| Política de aprovação (Approval Policy) | O fluxo que rege uma solicitação: quórum (any-of), unânime (all-of) ou sequencial, com escalonamento. |
| Base de conhecimento (Knowledge Base) | Um conjunto de documentos que enriquece o contexto de um agente (ou de todos) na correspondência de ferramentas e nas conversas. |
| Log de auditoria (Audit Log) | Registro append-only de todo evento relevante, com severidade, ator, IP de origem e correlação por sessão. |
| Papel (Role) | O nível de permissão de um usuário humano na plataforma: leitor, revisor, admin ou super admin. |
| Provedor de identidade (Identity Provider) | Um serviço de SSO corporativo (compatível com OIDC) usado para login federado dos usuários. |
Duas identidades distintas
O AgentHub trabalha com dois sistemas de identidade separados — não os confunda:
| Sistema | Quem usa | Credencial | Alcance |
|---|---|---|---|
| Identidade da plataforma | Pessoas (admins, revisores, leitores) | Token de acesso (login ou SSO) | Todos os endpoints da plataforma |
| Identidade do agente | Agentes de IA em execução | client_secret | Apenas o endpoint de conversa do próprio agente |
Veja os detalhes em Usuários e papéis e em Agentes.
Estados de um agente
| Estado | Significado |
|---|---|
| Pendente de aprovação (pending_approval) | Registrado, mas ainda sem nenhuma ferramenta aprovada. Não pode conversar. |
| Ativo (active) | Tem ao menos uma ferramenta aprovada e vigente. Pode conversar. |
| Suspenso (suspended) | Todas as ferramentas expiraram. Não pode conversar até uma re-aprovação. |
Próximo passo
Veja Como funciona para entender como esses conceitos se encadeiam no ciclo de vida de privilégio mínimo.