Crie um agente de IA externo com integração manual

Crie um agente de IA externo integrando manualmente um agente de terceiros no Estúdio de agentes de IA para usar em fluxos de trabalho do agentic.

Antes de Iniciar

Função necessária: sn_aia.admin

Procedimento

1. Navegar até Tudo > Studio do agente de IA > Criar e gerenciar > Agentes de IA.
2. Selecionar Novo(a) > Externo.
3. Selecione Integração manual método.
4. Na etapa Conectar um provedor, preencha os campos do formulário para se conectar ao seu agente de IA.
   1. Na seção Inserir detalhes sobre o provedor, selecione o alias e o subfluxo do agente de IA externo.

      Seu alias deve apontar para o provedor de IA do agente e incluir um token de autenticação. Você pode criar um alias selecionando Criar novo alias . Depois que o registro é criado, você pode atualizar ou iniciar a configuração assistida novamente para ver a nova opção.

      . API type. Subfluxo . Selecione um subfluxo que corresponda ao provedor. Você pode criar seu próprio selecionando Crie um novo subfluxo .

   2. Na seção Inserir detalhes iniciais sobre o agente de IA externo, preencha os campos.

      Tabela 1. Insira os detalhes iniciais sobre os campos do formulário da seção do agente de IA externo

      Nome	Descrição
      ID do agente	Identificador exclusivo para seu agente de acordo com seu provedor de IA do agente.
      Metadados	JSON estruturado que inclui os campos obrigatórios para que seu agente de IA funcione, por exemplo modelQue o agente de IA usa.
      Modo de comunicação	Qualquer um deles Síncrono (tempo real) ou Assíncrono (permite atraso).
      Analisar resposta	True ou false.

   Selecione Salve e continue para navegar para a próxima etapa.

   

5. Na etapa Diferenciar e definir, adicione detalhes sobre o agente de IA para fornecer ao orquestrador do agente de IA contexto sobre como utilizar o agente em fluxos de trabalho do agente.
   1. Na seção Descrever o agente de IA, adicione um nome e uma descrição para o agente de IA externo.

      O nome e o campo de descrição são usados pelo orquestrador do agente de IA para ajudar a determinar quando usar seu agente de IA. Quanto mais detalhada for sua descrição, maior será a probabilidade de o agente de IA ser usado corretamente no fluxo de trabalho do agente.

      Você pode selecionar Use o Now Assist Para ajudar a gerar o conteúdo para os campos de nome, descrição, função do agente de IA e instruções. Você ainda pode fazer mudanças depois que esses campos forem gerados.

   2. Na seção Instruir o agente de IA, adicione a função e as instruções do agente de IA.

      Esses campos fornecem contexto para o orquestrador do agente de IA ajudar a entender as funções e as etapas necessárias para que o agente de IA tenha atendido à sua finalidade no fluxo de trabalho. Informações detalhadas de função e instrução criam agentes de IA mais eficazes. Para obter sugestões para escrever funções e instruções do agente de IA, consulte Diretrizes gerais para criar agentes de IA e fluxos de trabalho do agente

   3. Configure ACLs (Access Control Lists, listas de controle de acesso) 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 Implemente o controle de acesso para segurança em 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 é a opçã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. Escolha uma mensagem de processamento a ser exibida para o 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.

   

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 e pode ser usado em fluxos de trabalho do agente do .

O que Fazer Depois

Você pode testar o agente de IA ou adicioná-lo a um fluxo de trabalho de agente novo ou existente.