Ferramentas, modelos e execuções dos agentes
Ferramentas permitem que um agente acesse funções além de responder em texto. Modelos são os mecanismos de IA oferecidos à organização. Execuções ajudam a investigar como o agente processou uma solicitação e se houve falha de ferramenta.
Abra Agent Runtime > Ferramentas com a permissão necessária e escolha criar.
- Abra Agent Runtime > Ferramentas com a permissão necessária e escolha criar.
O guia em texto
Mesmo conteúdo do player, para ler no seu ritmo.
Passo 1: Abra Agent Runtime > Ferramentas com a permissão necessária e escolha criar.
- Abra Agent Runtime > Ferramentas com a permissão necessária e escolha criar.
Passo 2: Preencha nome, identificador, descrição e categoria
- Preencha nome, identificador, descrição e categoria. A descrição deve explicar quando o agente deve usar a função.
Passo 3: Escolha o tipo de execução e preencha sua configuração
- Escolha o tipo de execução e preencha sua configuração. Para integrações externas, envolva o responsável técnico na definição do destino, parâmetros e credenciais.
Passo 4: Confira os parâmetros de entrada, inclusive os derivados das variáveis da configuração.
- Confira os parâmetros de entrada, inclusive os derivados das variáveis da configuração.
Passo 5: Revise e publique a ferramenta; depois associe-a ao agente no editor apropriado.
- Revise e publique a ferramenta; depois associe-a ao agente no editor apropriado.
Passo 6: Faça um teste controlado do agente e confira a execução e o efeito no sistema de destino.
- Faça um teste controlado do agente e confira a execução e o efeito no sistema de destino.
Passo 7: Como escolher um modelo
- Abra Agent Runtime > Modelos para consultar e filtrar o catálogo por provedor. Use as opções expostas no editor do agente para selecionar o modelo. Disponibilidade, consumo e capacidades variam; não suponha que todo modelo do mercado esteja habilitado à sua conta.
Passo 8: Como acompanhar execuções
- Abra Agent Runtime > Execuções, selecione período/status e entre num registro. Confira entrada, resposta, estado, erros e chamadas de ferramentas que a tela disponibilizar. Para investigar, anote o horário e o identificador da execução, sem copiar dados sensíveis desnecessários.
Ferramentas, modelos e execuções dos agentes
Disponibilidade: Disponível conforme plano, permissões e configuração da organização.
Acesso de referência: /agent-runtime/tools.
O que faz e quando usar
Ferramentas permitem que um agente acesse funções além de responder em texto. Modelos são os mecanismos de IA oferecidos à organização. Execuções ajudam a investigar como o agente processou uma solicitação e se houve falha de ferramenta.
Como configurar uma ferramenta
- Abra Agent Runtime > Ferramentas com a permissão necessária e escolha criar.
- Preencha nome, identificador, descrição e categoria. A descrição deve explicar quando o agente deve usar a função.
- Escolha o tipo de execução e preencha sua configuração. Para integrações externas, envolva o responsável técnico na definição do destino, parâmetros e credenciais.
- Confira os parâmetros de entrada, inclusive os derivados das variáveis da configuração.
- Revise e publique a ferramenta; depois associe-a ao agente no editor apropriado.
- Faça um teste controlado do agente e confira a execução e o efeito no sistema de destino.
Como escolher um modelo
Abra Agent Runtime > Modelos para consultar e filtrar o catálogo por provedor. Use as opções expostas no editor do agente para selecionar o modelo. Disponibilidade, consumo e capacidades variam; não suponha que todo modelo do mercado esteja habilitado à sua conta.
Como acompanhar execuções
Abra Agent Runtime > Execuções, selecione período/status e entre num registro. Confira entrada, resposta, estado, erros e chamadas de ferramentas que a tela disponibilizar. Para investigar, anote o horário e o identificador da execução, sem copiar dados sensíveis desnecessários.
Resultado esperado
O agente usa a ferramenta no caso previsto e o histórico permite conferir seu resultado. Uma resposta textual bem-sucedida não comprova que uma ação externa foi concluída.
Dúvidas frequentes
O teste no assistente de criação deu sucesso. A integração está validada? Não necessariamente. Na versão analisada, essa prévia verifica a entrada em JSON e apresenta um retorno demonstrativo. Confirme a integração por uma execução real controlada após configurar o agente.
Posso cadastrar uma ferramenta e ela começar a ser usada por todos os agentes? Não presuma isso. Confira a associação e as permissões no agente específico.
Limitações
Ferramentas podem produzir efeitos externos. Um teste real deve usar dados e ações apropriados ao ambiente. Histórico técnico não deve ser reproduzido integralmente numa resposta pública ao cliente.