Ir para o conteúdo

Atividade Registrar Ferramentas do Anthropic Claude no Jitterbit Studio

Introdução

Uma atividade Registrar Ferramentas do Anthropic Claude, usando sua conexão Anthropic Claude, registra ferramentas para uso com modelos Claude e destina-se a ser usada como uma fonte para fornecer dados em uma operação. Os esquemas de ferramentas podem ser originários da atividade Listar Ferramentas do conector MCP Client ou fornecidos diretamente através da transformação de solicitação como definições de funções personalizadas.

Quando a operação é executada, o Jitterbit armazena os esquemas de ferramentas registrados na memória do agente privado. Qualquer operação encadeada para ser executada após esta tem acesso automático a esses esquemas ao chamar o LLM. Não é necessário capturar a resposta de Registrar Ferramentas ou passar as definições de ferramentas explicitamente para a operação Prompt subsequente.

Importante

Para usar a atividade Registrar Ferramentas, é necessário usar um agente privado.

Criar uma atividade Registrar Ferramentas do Anthropic Claude

Uma instância de uma atividade Registrar Ferramentas do Anthropic Claude é criada a partir de uma conexão Anthropic Claude usando seu tipo de atividade Registrar Ferramentas.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a tela de design ou copie o tipo de atividade e cole-o na tela de design. Para detalhes, consulte Criando uma instância de atividade em Reutilização de componentes.

Uma atividade Registrar Ferramentas do Anthropic Claude existente pode ser editada a partir destes locais:

Configurar uma atividade Registrar Ferramentas do Anthropic Claude

Siga estas etapas para configurar uma atividade Registrar Ferramentas do Anthropic Claude:

Etapa 1: Insira um nome e especifique as configurações

Nesta etapa, forneça um nome para a atividade, selecione um modelo e especifique um prompt e configurações opcionais. Cada elemento da interface do usuário desta etapa é descrito abaixo.

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete de abertura [ no campo ou clique no ícone de variável para exibir um menu listando as variáveis existentes para escolher.

  • Menu Endpoint: Se você tiver vários endpoints do mesmo tipo de conector configurados, um menu na parte superior da tela exibe o nome do endpoint atual. Clique no menu para alternar para um endpoint diferente. Para mais informações, consulte Alterar o endpoint atribuído em Telas de configuração.

    • Editar endpoint: Aparece quando você passa o mouse sobre o nome do endpoint atual. Clique para editar a configuração de conexão do endpoint selecionado no momento.

  • Nome: Digite um nome para identificar a atividade. O nome deve ser único para cada atividade Register Tools do Anthropic Claude e não pode conter barras / ou dois-pontos :.

  • Chat ID: Opcionalmente, digite um ID de chat para recuperar o contexto de uma conversa anterior.

  • Escolher opção: Especifique o método de seleção de modelo, seja Listar todos os modelos ou Inserir identificador de modelo.

  • Listar todos os modelos: Selecione esta opção para escolher entre uma lista de modelos Claude suportados:

    • Selecionar um modelo: Esta seção exibe os modelos disponíveis para o endpoint do Anthropic Claude.

      • Modelo selecionado: Após selecionar um modelo, ele é listado aqui.

      • Pesquisar: Digite o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de modelos. A pesquisa não diferencia maiúsculas de minúsculas. Se os modelos já estiverem exibidos na tabela, os resultados da tabela são filtrados em tempo real a cada digitação. Para recarregar modelos do endpoint ao pesquisar, digite os critérios de pesquisa e depois atualize, conforme descrito abaixo.

      • Atualizar: Clique no ícone de atualização ou na palavra Atualizar para recarregar modelos do endpoint do Anthropic Claude. Isso pode ser útil se os modelos foram atualizados. Esta ação atualiza todos os metadados usados para construir a tabela de modelos exibida na configuração.

      • Selecionando um modelo: Na tabela, clique em qualquer lugar em uma linha para selecionar um modelo. Apenas um modelo pode ser selecionado. As seguintes informações estão disponíveis para cada modelo:

        • Nome de exibição: O nome de exibição do modelo.

        • ID: O ID do modelo usado em solicitações de API.

        • Lançado: A data de lançamento do modelo.

      Dica

      Se a tabela não for preenchida com modelos disponíveis, a conexão do Anthropic Claude pode não ter sido bem-sucedida. Certifique-se de estar conectado reabrindo a conexão e testando novamente as credenciais.

      Alternativamente, o modelo pode ser especificado no campo Model ID ou fornecido na transformação de solicitação. Se um modelo for especificado em vários locais, a seguinte ordem de precedência é seguida:

      1. Um modelo fornecido na transformação de solicitação substitui todos os campos abaixo.
      2. Um modelo especificado no campo Model ID substitui o campo restante abaixo, mesmo se Listar todos os modelos estiver selecionado.
      3. Um modelo selecionado na lista Selecionar um modelo tem a menor precedência.

  • Inserir identificador de modelo: Selecione esta opção para inserir manualmente o ID de um modelo Claude.

    • Model ID: Digite o ID do modelo.

  • Prompt: Digite o texto para fazer o prompt do modelo.

  • Configurações opcionais: Clique para expandir configurações opcionais adicionais:

    • Max Output Tokens: Digite o número máximo de tokens a gerar na resposta. O padrão é 2000. O valor máximo depende do modelo selecionado. Consulte a visão geral dos modelos Anthropic para limites de tokens de saída por modelo.

    • Ativar pensamento estendido: Selecione para ativar o pensamento estendido, que permite ao modelo raciocinar sobre problemas complexos antes de gerar uma resposta. Esta opção está desativada por padrão.

      Importante

      O pensamento estendido não é suportado por todos os modelos Claude. Se esta opção estiver ativada para um modelo que não a suporta, o Anthropic retorna um erro. Consulte a visão geral dos modelos Anthropic para confirmar se o modelo selecionado suporta pensamento estendido.

      • Effort: Selecione o nível de esforço de raciocínio a aplicar. Esta configuração fica visível quando Ativar pensamento estendido está selecionado. As opções são Baixo, Médio, Alto (padrão), Extra Alto e Máximo. Níveis de esforço mais altos permitem raciocínio mais completo, mas aumentam o tempo de resposta e o uso de tokens.

    • Ativar cache de prompt: Selecione para ativar o cache de prompt, que permite ao modelo reutilizar conteúdo processado anteriormente e reduzir latência e custo para componentes de prompt repetidos. Esta opção está desativada por padrão.

  • Cache Up To: Selecione a parte do prompt a ser armazenada em cache. Esta configuração fica visível quando Enable Prompt Caching está selecionado. As opções seguem uma hierarquia aditiva, onde cada nível inclui todo o conteúdo dos níveis acima:

        -   **Tools:** Armazena em cache apenas as definições de ferramentas fornecidas ao modelo.
    -   **Tools + System Prompt:** (Padrão.) Armazena em cache as definições de ferramentas e o prompt do sistema.
    -   **Tools + System + Chat History:** Armazena em cache as definições de ferramentas, o prompt do sistema e o histórico de chat completo.

    Para mais detalhes, consulte a [documentação de prompt caching do Anthropic](https://platform.claude.com/docs/en/build-with-claude/prompt-caching).
    • Continue on error: Selecione para continuar a execução da atividade se um erro for encontrado para um conjunto de dados em uma solicitação em lote. Se algum erro for encontrado, ele será registrado no log de operação.

  • Save & Exit: Se habilitado, clique para salvar a configuração desta etapa e fechar a configuração da atividade.

  • Next: Clique para armazenar temporariamente a configuração desta etapa e continuar para a próxima. A configuração não será salva até que você clique no botão Finished na última etapa.

  • Discard changes: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 2: Revisar os esquemas de dados

Todos os esquemas de solicitação ou resposta são exibidos. Cada elemento da interface do usuário desta etapa é descrito abaixo.

  • Data schema: Estes esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante o mapeamento de transformação.

    Nota

    Os dados fornecidos em uma transformação têm precedência sobre a configuração da atividade.

    O conector Anthropic Claude usa a API do Anthropic. Consulte a documentação da API para obter informações sobre os nós de esquema e campos.

  • Refresh: Clique no ícone de atualização ou na palavra Refresh para regenerar esquemas do endpoint Anthropic Claude. Esta ação também regenera um esquema em outros locais do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

  • Back: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

  • Finished: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.

  • Discard changes: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade Register Tools do Anthropic Claude, conclua a configuração da operação adicionando e configurando outras atividades, transformações ou scripts como etapas da operação. Você também pode configurar as definições da operação, que incluem a capacidade de encadear operações que estão no mesmo fluxo de trabalho ou em fluxos diferentes.

Para concluir um fluxo de trabalho de chamada de ferramentas, encadeie uma operação Prompt para ser executada após esta. Como o Jitterbit armazena os esquemas de ferramentas na memória do agente privado, a operação Prompt os recebe automaticamente sem necessidade de mapeamento adicional. Para vincular a operação Prompt ao histórico de conversa desta sessão, capture o chatId da resposta Register Tools e passe-o para a atividade Prompt na transformação de solicitação.

As ações de menu para uma atividade são acessíveis no painel do projeto e na tela de design. Para mais detalhes, consulte Activity actions menu em Connector basics.

As atividades Register Tools do Anthropic Claude podem ser usadas como uma fonte com estes padrões de operação:

Para usar a atividade com funções de script, escreva os dados em um local temporário e depois use esse local temporário na função de script.

Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.