O que é e como funciona

Manual de Agentes de IA · capítulo 1 de 7

O H2O tem um servidor de agentes: um endereço que programas de inteligência artificial usam para consultar o sistema em nome de uma pessoa. Ele segue o MCP (Model Context Protocol), o padrão aberto adotado pelos principais assistentes — Claude, ChatGPT, Copilot, Gemini — e por agentes feitos sob medida. Você conecta uma vez e o assistente passa a responder perguntas como “quantos chamados estão abertos?”, “o que está programado para esta semana?” ou “mostre o histórico do nobreak da sala norte”.

Regra do sistema

O agente age em nome de um usuário do H2O e enxerga exatamente o que esse usuário enxerga: os mesmos sites, os mesmos direitos do perfil. Ele nunca vê dados de outro site nem de outra empresa.

O agente pode	O agente não pode
Consultar chamados, tarefas, ativos e suas medições, projetos, sites e o calendário de manutenção	Ver qualquer coisa fora do alcance do usuário que o autorizou
Abrir chamado e acrescentar acompanhamento, se você liberar a escrita	Alterar ou excluir cadastros, fechar ou reatribuir chamados, mexer em usuários, perfis ou configurações
Buscar um texto em chamados, tarefas e ativos de uma vez	Exportar relatórios ou baixar arquivos

Há duas formas de conectar, explicadas nos capítulos seguintes: por chave de API, indicada para agentes próprios e ferramentas de desenvolvimento, e por autorização (OAuth), usada pelos aplicativos de conversa, em que a pessoa aprova o acesso numa tela do próprio H2O.