Crie um agente de IA externo com o protocolo Agent2Agent

Crie agentes de IA externos em Estúdio de agentes de IA para conectar o. ServiceNow AI Platform Com provedores de IA de agentes de terceiros.

Antes de Iniciar

Se você não vir a opção para criar um agente externo, confirme se o administrador selecionou Permita que a ServiceNow acesse agentes de IA externos . Esta opção está disponível no Configurações página em Estúdio de agentes de IA, em Agentes de IA externos > Capacidade de descoberta.

Sua instância deve estar pelo menos no patch 4 da Zurich.

Função necessária: sn_aia.admin

Por Que e Quando Desempenhar Esta Tarefa

Você pode integrar provedores de IA de terceiros ao ServiceNow AI Platform Criando um agente de IA externo em Estúdio de agentes de IA.

Procedimento

1. Navegar até Tudo > Studio do agente de IA > Criar e gerenciar > Agentes de IA.
2. Selecionar Novo(a) > Externo.
3. Em Descobrir e ativar Selecione o provedor do agente de IA para seu agente externo e descubra seu agente.
   Selecione Salve e continue para navegar para a próxima etapa.
   1. Selecione um provedor existente ou adicione um novo provedor.

      Se você selecionar Adicionar novo provedor você deve preencher os campos e selecionar Salvar .

      Tabela 1. Campos de formulário Adicionar novos provedores

      Nome	Descrição
      Nome	Nome do provedor de IA do agente.
      URL do cartão do agente	O URL que aponta para o cartão de agente do agente de IA externo. O URL deve incluir well_known/agent_json .
      Em Configurações avançadas Alias de conexão e credencial	Credenciais para acessar o cartão do agente de IA externo. Você pode selecionar um alias existente ou criar um.
      Em Configurações avançadas Selecione subfluxo	Subfluxo que estabelece o protocolo Agent2Agent. O subfluxo padrão deve lidar com a maioria dos casos, mas você também pode criar o seu próprio.

   2. Selecione Descobrir agente de IA externo para validar a conexão com seu agente externo.

      Se a descoberta for bem-sucedida, o nome do seu agente e o número da versão serão adicionados à página abaixo do botão Descobrir agente de IA externo.

      

   3. Selecione o nome do agente para verificar se Name, Version, Descriptione Skillsos campos são preenchidos corretamente e selecione Ativar .

      . Cartão do agente Mostra o JSON inteiro do agente.

      
4. Em Revise habilidades e capacidades etapa, verifique se os nomes das habilidades estão corretos.
5. Em Defina a especialidade Etapa, adicione detalhes de como o agente externo se encaixa no sistema agentic da ServiceNow.
   1. Revise a descrição do seu agente de IA.

      Você pode deixar a descrição do agente de IA como ela está ou adicionar uma descrição mais longa para ajudar a diferenciar o agente de outros agentes de IA. Isso ajuda a permitir que o orquestrador de agentes de IA use seu agente de IA externo com mais eficiência. Para obter sugestões para escrever descrições de agentes com IA, consulte Diretrizes gerais para criar agentes de IA e fluxos de trabalho do agente .

   2. Defina o modo de comunicação como qualquer um Síncrono ou Assíncrono .

      Alguns agentes não são compatíveis com comunicação assíncrona.

      Em Configurações avançadas , você pode usar o subfluxo padrão, um subfluxo existente ou criar um subfluxo. O subfluxo padrão deve funcionar para a maioria dos casos.

   3. Selecione o alias de conexão e credencial de execução do agente de IA para autenticação.

      Escolha quais credenciais acessam o endpoint de execução do agente de IA externo. Você pode selecionar um alias existente ou criar um. Se você criar um, um modal será exibido com opções para configurar uma autenticação de chave de API ou OAuth.

      

   4. Configure listas de controle de acesso (ACLs) para o agente de IA.
      Nota:

      As ACLs determinam quem tem acesso para descobrir e executar o agente de IA. Para saber mais sobre as ACLs que você pode criar em Estúdio de agentes de IA e como adicionar configurações de segurança mais avançadas, consulte Implementar controle de acesso em Now Assist Agentes de IA.

      Esta é uma etapa obrigatória. Se você configurou anteriormente um agente de IA sem criar uma ACL, deverá gerar uma ACL antes de fazer outras modificações.

      Tabela 2. Defina quem pode acessar o agente de IA

      Campo	Descrição
      Acesso de usuário	O tipo de usuários cujo acesso ao agente de IA é definido pelas seguintes opções: Qualquer usuário autenticado : Qualquer usuário conectado pode acessar o agente de IA. Usuários com funções específicas : Os usuários que têm pelo menos uma das funções atribuídas a eles podem acessar o agente de IA. Esta opção é o padrão. Nota: Se um usuário não tiver acesso a um agente de IA ou se o usuário não tiver acesso a pelo menos um dos agentes de IA na respectiva execução do fluxo de trabalho do agente, toda a execução será anulada antes que o primeiro agente de IA seja iniciado. Público : Qualquer usuário pode acessar o agente de IA mesmo sem fazer login. Use esta opção somente quando quiser que os convidados possam acessar o agente de IA.
      Função	Atribua uma ou mais funções específicas no menu suspenso. Nota: Selecionar a função só é possível quando você escolhe Usuários com funções específicas acesso do usuário.

6. Em Selecione uma exibição Etapa, escolha onde você deseja que o agente de IA apareça e qual mensagem os usuários verão quando o agente de IA estiver em execução.
   1. Selecione a disponibilidade do seu agente de IA.
      Defina StatusSe você quiser que o agente de IA esteja disponível para usuários com a função correta.
   2. Selecione um canal de exibição.

      Você pode optar por usar um Virtual Agent E especifique qual assistente você deseja acessar o agente de IA. Se você quiser testar o agente de IA primeiro, ainda não precisa selecionar um canal de exibição.

   3. Escolha processando mensagens para exibir ao usuário quando o agente de IA estiver em execução.

      Por exemplo, Initiating AI agentou Processing record detailsou An AI agent is looking into the request.

   4. Ative o agente de IA.

      Selecione o botão para ativar o agente de IA se quiser que o agente de IA seja detectável. Se você quiser testar seu agente de IA primeiro, aguarde até depois de testá-lo antes de ativá-lo.

      Se você não vir esta opção, talvez seja necessário rolar a tela.

   

7. Selecione Salve e teste Para salvar os detalhes do agente de IA e ir para a página de teste de Estúdio de agentes de IA.

Resultado

Seu agente de IA externo está conectado à ServiceNow.

O que Fazer Depois

Você pode Teste uma execução do seu agente de IA ou seu acesso aos dados . Você também pode adicioná-lo a um fluxo de trabalho agentivo novo ou existente. Consulte Crie um fluxo de trabalho agentivo para as etapas para criar ou configurar um fluxo de trabalho agentivo.