Todos os produtos
Search

Este produto

    Platform For AI:Configure ferramentas para o Agent

    Central de documentação

    Platform For AI:Configure ferramentas para o Agent

    Última atualização: Oct 09, 2026

    Estenda as capacidades do Agent configurando ferramentas para integração com service externos, execução de código e recuperação de conhecimento.

    Visão geral das ferramentas

    O LangStudio oferece cinco tipos de ferramentas para integrar capacidades externas:

    • MCP Tool: registre service de backend compatíveis com MCP na plataforma. Os agentes os invocam sob demanda para interagir com segurança com sistemas externos.

    • Custom Tool (OpenAPI Tool): forneça um arquivo de especificação OpenAPI 3.0+. A plataforma converte cada endpoint de API em uma ferramenta chamável.

    • Python Tool: escreva funções Python. A plataforma extrai assinaturas, anotações de tipo e docstrings para gerar descrições de ferramentas para invocação do Agent.

    • Knowledge Base Tool: conecte bases de conhecimento corporativas aos nós do Agent para recuperação sob demanda durante a inferência.

    • Web Search Tool: recupere informações em tempo real da web. Os agentes consultam automaticamente os mecanismos de busca para obter notícias e fatos atuais.

    Selecione um tipo de ferramenta com base no seu caso de uso:

    Tipo de ferramenta

    Caso de uso

    Principais recursos

    MCP Tool

    Microsserviços internos, API privadas

    Integração de baixo custo, observabilidade integrada

    Custom Tool

    SaaS de terceiros, service RESTful

    Integração sem código

    Python Tool

    Processamento de lógica complexa, computação local

    Programação flexível, integração profunda com o ecossistema Python

    Knowledge Base Tool

    Perguntas e respostas com conhecimento proprietário

    Pronto para uso, recuperação automática pelo Agent

    Web Search Tool

    Consultas de informações em tempo real, notícias recentes

    Recuperação automática na web

    Diretrizes de combinação:

    • Um Agent suporta múltiplas ferramentas. Por exemplo, combine o MCP Tool (chamadas de API internas) com o Python Tool (processamento de dados) para lógicas de negócio complexas.

    • Se uma API não tiver suporte a MCP, mas possuir uma especificação OpenAPI, comece com o Custom Tool para uma integração rápida e depois migre para o MCP Tool para obter melhor observabilidade.

    Configure o MCP Tool

    Crie a conexão do MCP Tool

    1. Acesse o LangStudio. Em seguida, acesse Tools > MCP Tool e clique em Create Tool.

    2. Selecione o método de criação:

      • FunctionAI: configure service MCP criados via Explore > MCP Template.

        • Selecione um service MCP implantado. O sistema preenche automaticamente os parâmetros de conexão.

      • Custom: configure service MCP implantados por você ou hospedados por terceiros.

        • transport: protocolo de transporte para comunicação MCP. Suporta SSE e StreamableHTTP.

        • url: URL completa do endpoint do service MCP.

        • authentication: método de autenticação para o service MCP. Há suporte para três tipos:

          • BearerAuth: autenticação por token Bearer. Insira um token de acesso válido no campo token.

          • Other: especifique auth_header_name e token para definir o cabeçalho que transporta o token.

          • None: nenhuma autenticação necessária.

    3. (Opcional) Execute um teste de conectividade para verificar se o service MCP está acessível.

    4. Clique em Envie para criar a ferramenta.

    Configure o nó do Agent

    Na página de configuração do nó do Agent, localize MCP Tool. Há dois métodos disponíveis:

    • Selecione uma conexão de ferramenta MCP existente: primeiro, crie uma conexão de ferramenta MCP reutilizável. Consulte Crie a conexão da ferramenta MCP para mais detalhes. Um service MCP geralmente fornece várias ferramentas; você pode limitar o escopo das ferramentas e exigir aprovação para ferramentas sensíveis.

      • Use o escopo da ferramenta para controlar quais ferramentas o modelo pode ver.

      • Para operações sensíveis (como a modificação de dados do usuário), ative Approval tools. O nó pausa nessas ferramentas e aguarda aprovação manual antes de continuar.

    • Configuração MCP personalizada: disponível apenas neste nó.

    image

    Configure outros tipos de ferramentas

    Na página de configuração do nó do Agent, acesse Tools para adicionar ferramentas. Para cada ferramenta, você pode editar a descrição, "Needs Approval" e outros parâmetros.image

    • Knowledge Base: consulte Gerencie as bases de conhecimento para criar uma base de conhecimento antes de adicioná-la ao Agent.

    • Custom Tool (OpenAPI Tool):

      • Selecione uma ferramenta personalizada existente ou Create Custom Tool.

      • Crie ferramentas a partir de service do LangStudio já implantados no PAI-EAS ou insira manualmente uma especificação OpenAPI.

      • Após a criação, use o recurso Test na página de detalhes da ferramenta, envie solicitações de exemplo e verifique as respostas.

    • Python Tool:

      • Selecione uma ferramenta existente ou Create Python Tool.

      • Para uma nova ferramenta, defina o nome do conjunto de ferramentas e, em seguida, edite e teste o código na página aberta.

      • Visualize ou edite ferramentas Python existentes: clique em More > Code-only Mode no canto superior direito. Os arquivos estão na pasta tools dentro do diretório source da aplicação.