Atividades

Agents podem usar atividades do Integration Service como ferramentas.

Por meio de conexões seguras e governadas do Integration Service e das configurações de campo descritas nas seções a seguir, um agente é capaz de fazer chamadas de API diretamente para um aplicativo de negócios de destino.

Observação:

Nem todas as atividades do Integration Service estão disponíveis em Agents. A disponibilidade de atividade também pode depender de sua oferta de cloud — por exemplo, as atividades da GenAI podem não estar totalmente disponíveis no Dedicated. Para obter detalhes, consulte Disponibilidade de funcionalidades.

Configurar atividades para atuar como ferramentas

1. Na aba Design, na seção Ferramentas, selecione Adicionar ferramenta.
2. Na Caixa de ferramentas:
   • Pesquise uma atividade usando a barra de pesquisa ou
   • Selecione Atividade e navegue por conector. Selecionar um conector revela a lista de atividades compatíveis.
3. Depois de adicionar uma atividade como uma ferramenta, você pode:
   1. Edite o nome e a descrição da ferramenta.
   2. Selecione uma conexão existente do Integration Service ou crie uma nova.
   3. Configure os campos de entrada para ensinar seu agente a usar a atividade.

Cada atividade vem com uma descrição padrão, que você pode personalizar para orientar melhor seu agente durante a execução. Embora opcional, essa etapa melhora a qualidade de saída e ajuda o agente a entender como usar a ferramenta para casos de uso específicos.

Definição de métodos de entrada de atividade

Os agentes podem automaticamente inferir as informações necessárias para executar uma atividade com sucesso, para que você normalmente não precise definir valores de entrada ou saída manualmente. Por padrão, os agentes determinam os valores de campo apropriados no runtime com base na descrição e no contexto da ferramenta.

No entanto, você pode substituir esse comportamento para qualquer campo selecionando um método de entrada diferente usando o menu de contexto. Os métodos de entrada disponíveis são:

• Solicitação (padrão) – O agente infere o valor do campo no runtime usando a descrição da ferramenta e outras informações relevantes.
• Argumento – O campo é preenchido usando um argumento de entrada de agente. Você deve definir o argumento de antemão. Essa opção é útil para passar dados de um fluxo de trabalho anterior para o agente por meio da atividade Executar agente.
• Valor estático – O campo é definido como um valor fixo que permanece o mesmo todas as vezes que o agente é executado.

Observação:

Os campos em cascata não podem ser definidos como o método de entrada Solicitação. Esses são campos em que a seleção de um valor específico (por exemplo, um tipo de problema no Jira) altera a estrutura dos campos restantes na atividade. Como o esquema da ferramenta não pode se ajustar dinamicamente no runtime, os agentes não podem inferir valores para esses campos. Outros campos têm o padrão de Solicitação e podem ser inferidos pelo LLM no runtime. No entanto, você deve garantir que o agente tenha acesso ao contexto necessário (por exemplo, por meio de ferramentas anteriores, solicitação ou argumentos) para inferir esses valores corretamente.

Recuperação de contexto da Web

Pesquisa na Web e Leitor de Web são duas ferramentas próprias que você pode adicionar aos seus agentes para fornecer contexto atualizado da Web ou de um domínio público. Você pode usar as atividades para fazer perguntas sobre dados em tempo real, como preços de ações, o período, previsões do tempo ou dados disponíveis em um URL específico a qualquer momento.

Pesquisa na web

The Web Search tool executes a web search using natural language. Like other tools, the Search field can be inferred from instructions in the system and user prompt. For instance, you can tell your agent to get details on industry trends and competitor activities which would be used to construct a forecasting report.

By offering the instruction in your prompt and adding the Web Search tool, the agent knows it needs to use the tool to access this critical, up-to-date context.

A Pesquisa na Web executa um resumo completo e o fornece ao agente com base nos principais resultados. A saída inclui os URLs de onde as informações foram obtidas.

Leitor de Web

The Web Reader tool gives you the ability to extract text from a specific URL and add that as context for your agent. For instance, you have a specific parts supplier and you want to go to their web page and extract current prices for those parts.

By supplying the URL directly or through the prompt, you ensure that only information from that individual URL is used for surfacing the supplier's prices for specific parts (or any other information contained in that URL).

Ao combinar a Pesquisa na Web e o Leitor de Web, você dá ao seu agente a capacidade de executar pesquisas no domínio público e, em seguida, usar as fontes e URLs citados para extrair detalhes específicos.

Limitações

No momento, os modelos do Gemini não oferecem suporte a atividades do Integration Service como ferramentas de agente.