A interoperabilidade de agentes permite que você gerencie como a automação e os agentes de IA se comunicam no seu ambiente. Dependendo das suas permissões, você pode exibir, criar, editar ou excluir conexões de agentes na Control Room.

Funções e permissões

Operações de gerenciamento, como exibir, criar, editar e excluir conexões de agentes, dependem do controle de acesso baseado em funções (RBAC). As permissões que um usuário tem determinam as operações pode executar.

A tabela a seguir lista as permissões de conexão relacionadas a agentes:
Permissão do usuário Ações permitidas
Exibir conexões de agentes Fornece acesso somente para exibição de todas as conexões e ferramentas de agentes configuradas.
Gerenciar conexões de agentes Fornece acesso para exibir, criar, editar, excluir e habilitar ou desabilitar conexões e ferramentas de agentes.
Nota: Usuários sem essas permissões não poderão visualizar o menu Conexões de agente no painel à esquerda, na seção Control Room → IA.
Certifique-se de que o usuário tenha as permissões corretas:
  • Visualizar: usuários com permissão para exibir conexões de agente podem ver todas as conexões de agentes registradas. Eles também podem verificar detalhes como endpoints, recursos e status da conexão.
  • Criar: usuários com permissão para gerenciar conexões de agentes podem criar ou registrar novos agentes ou conexões. Para obter detalhes sobre como adicionar uma conexão de agente, consulte Configure an MCP inbound tool.
  • Editar: usuários com permissão para gerenciar conexões de agentes podem alterar as informações sobre a conexão de agente. Isso inclui nomes, endpoints, credenciais e configurações.
  • Habilitar/desabilitar: usuários com permissão para gerenciar conexões de agentes podem habilitar ou desabilitar uma conexão de agente.
    • Habilitar: torna o agente disponível para descoberta e interação.
    • Desabilitar: remove o agente do uso ativo, mas não o exclui. As configurações ainda estarão lá se você quiser habilitá-las novamente no futuro.
  • Excluir: administradores com permissão para gerenciar conexões de agentes podem remover uma conexão de agente do registro de interoperabilidade. Isso impede que outros agentes e fluxos de trabalho tenham acesso a ele.
Nota: Sempre coordene as alterações, especialmente edições ou exclusões, com as partes interessadas relevantes para evitar a interrupção de fluxos de trabalho dependentes.

Essas ações controladas garantem que a comunicação entre agentes seja segura e consistente. Elas também ajudam a manter tudo auditável e alinhado com os padrões de conformidade da empresa. Se não tiver certeza sobre as permissões que você tem, entre em contato com o administrador da sua Control Room.

Exibir conexões de agentes

Para verificar quais agentes estão conectados, o que eles podem fazer e quem os configurou:
  1. Faça login na Control Room.
  2. Navegue até Conexões de IA->agente. Na página Conexões de agentes, você pode exibir a lista de conexões de agentes e ferramentas.

    Visualização de agente

  3. Para exibir os detalhes de uma conexão de agente específica, passe o cursor sobre o menu de ações (três pontos verticais) localizado à direita da conexão de agente e clique no ícone Exibir.
  4. É aberta a caixa de diálogo Exibir ferramenta de entrada, em que você pode ver:
    • Automação
    • Nome da ferramenta: usado para identificar a ferramenta durante a execução
    • Descrição da ferramenta: usado pela IA para determinar quando e como usar essa automação.
  5. Clique em Fechar para retornar à página Conexões de agentes.

Editar conexões de agentes

Nota: Como a Interoperabilidade de agentes funciona por meio de uma camada centralizada e controlada (registro + serviço de descoberta + protocolos de governança), a alteração de conexões pode afetar a capacidade de outros agentes encontrarem ou usarem o agente modificado. Tenha cuidado ao modificar endpoints ou credenciais. Se uma automação for atualizada, você precisará atualizar manualmente a conexão de agente.
Para usuários com as permissões adequadas:
  1. Faça login na Control Room.
  2. Navegue até Conexões de IA->agente. Na página Conexões de agentes, você pode exibir a lista de conexões de agentes e ferramentas.

    Edição de agente

  3. Localize o agente que você quer modificar. Passe o cursor sobre o menu de ações (três pontos verticais) localizado à direita da conexão de agente e clique no ícone Editar.
  4. É aberta a caixa de diálogo Editar ferramenta de entrada, em que você pode editar:
    • Nome da ferramenta: usado para identificar a ferramenta durante a execução
    • Descrição da ferramenta: usado pela IA para determinar quando e como usar essa automação.
  5. Clique em Salvar para retornar à página Conexões de agentes. O sistema revalidará a conexão (dependendo da sua implementação) para garantir que as configurações atualizadas sejam válidas.

Habilitar ou desabilitar conexões de agentes

Para usuários com as permissões adequadas:
  1. Faça login na Control Room.
  2. Navegue até Conexões de IA->agente. Na página Conexões de agentes, você pode exibir a lista de conexões de agentes e ferramentas.

    Desativação do agente

  3. Para habilitar ou desabilitar uma conexão de agente, localize a conexão que quer modificar e verifique a respectiva coluna Status.
  4. Passe o cursor sobre o menu de ações (três pontos verticais) localizado à direita da conexão de agente e clique no ícone Habilitar ou Desabilitar para alternar. A exibição do alternador muda com base no seu status.
  5. Dependendo da ação que você realizar, uma mensagem de confirmação será exibida perguntando se quer habilitar (ou desabilitar) a conexão de agente. Clique em Habilitar (ou Desabilitar ) para continuar ou em Cancelar para manter seu status atual.
  6. Clique em Salvar para retornar à página Conexões de agentes e verifique o status atualizado da conexão de agente.
    • Um agente habilitado pode ser localizado e usado por outros agentes ou fluxos de trabalho.
    • Um agente desabilitado é removido da descoberta ativa, de modo que outros agentes ou fluxos de trabalho não podem usá-lo.

Excluir conexões de agentes

Nota: Apenas usuários com permissão para gerenciar conexões de agentes podem executar essa ação. Quando você exclui o agente, ele é removido do registro e do serviço de descoberta. Ou seja, outros agentes não poderão mais encontrá-lo nem usá-lo. Se houver fluxos de trabalho ou tarefas que dependam desse agente, eles também não conseguirão encontrá-lo nem usá-lo. Cuide de todas as dependências antes de excluir o agente. Se uma automação for excluída, você precisará excluir manualmente a conexão de agente.
Para usuários com as permissões adequadas:
  1. Faça login na Control Room.
  2. Navegue até Conexões de IA->agente. Na página Conexões de agentes, você pode exibir a lista de conexões de agentes e ferramentas.

    Exclusão de agente

  3. Localize o agente que você quer excluir. Passe o cursor sobre o menu de ações (três pontos verticais) localizado à direita da conexão de agente e clique no ícone Excluir. Também é possível excluir várias conexões de agentes ao marcar a caixa de seleção à esquerda de cada conexão e clicar no ícone Excluir no canto superior direito da tabela.
  4. Uma mensagem de confirmação é exibida perguntando se você quer excluir permanentemente essa conexão de agente. Clique em Excluir para continuar; ou Cancelar para manter a conexão de agente.
  5. A página Conexões de agentes é exibida novamente sem a conexão de agente excluída.