Compartilhar via

Criação e uso do pacote de ferramentas personalizados

Ao desenvolver fluxos, você não só pode usar as ferramentas internas fornecidas pelo prompt flow, mas também desenvolver sua própria ferramenta personalizada. Neste artigo, orientaremos você no processo de desenvolvimento do próprio pacote de ferramentas, oferecendo etapas detalhadas e conselhos sobre como utilizar o pacote de ferramentas personalizado.

Após a instalação com êxito, sua "ferramenta" personalizada pode aparecer na lista de ferramentas: Captura de tela de ferramentas personalizadas na lista de ferramentas da IU.

Crie seu próprio pacote de ferramentas

Seu pacote de ferramentas deve ser um pacote python. Para desenvolver sua ferramenta personalizada, siga as etapas Criar seu próprio pacote de ferramentas e Compilar e compartilhar o pacote de ferramentas em Criar e usar pacote de ferramentas. Você pode encontrar diretrizes de desenvolvimento mais avançadas em Como desenvolver uma ferramenta.

Preparar sessão de computação

Para adicionar a ferramenta personalizada à sua lista de ferramentas para uso, é necessário preparar a sessão de computação. Aqui, usamos my-tools-package como exemplo.

Ao usar a sessão de computação, você pode instalar prontamente o pacote lançado publicamente adicionando o nome do pacote de ferramentas personalizado ao arquivo requirements.txt na pasta de fluxo. Em seguida, para iniciar a instalação, selecione o botão "Salvar e instalar". Após a conclusão, você poderá ver as ferramentas personalizadas exibidas na lista de ferramentas. Para saber mais, confira Como gerenciar a sessão de computação. Captura de tela de como instalar pacotes na sessão de computação.

Outro método é aplicável não apenas a pacotes lançados publicamente, mas também a pacotes de feeds locais ou privados. Primeiro, você deve criar uma imagem seguindo as duas etapas em como personalizar a imagem base para a sessão de computação e, em seguida, alterar a imagem base da sessão de computação.

Testar da interface do usuário do prompt flow

  1. Crie um fluxo padrão.

  2. Inicie a sessão de computação. Captura de tela do fluxo no Estúdio do Azure Machine Learning iniciando a sessão de computação.

  3. Adicione suas ferramentas. Captura de tela do fluxo no Estúdio do Azure Machine Learning mostrando mais ferramentas suspensas.

  4. Altere o fluxo com base nos requisitos e no fluxo de execução. Captura de tela do fluxo no Estúdio do Azure Machine Learning mostrando a adição de uma ferramenta.

Perguntas frequentes

Como instalar o pacote de ferramentas personalizado na extensão do VS Code?

  1. Instalar o prompt flow para a extensão do VS Code Captura de tela da extensão do VS Code do fluxo de prompt.

  2. Vá ao terminal e instale o pacote de ferramentas no ambiente conda da extensão. Considere que o nome do seu env conda seja prompt-flow.

    (local_test) PS D:\projects\promptflow\tool-package-quickstart> conda activate prompt-flow
(prompt-flow) PS D:\projects\promptflow\tool-package-quickstart> pip install my-tools-package==0.0.1

  3. Vá para a extensão e abra uma pasta de fluxo. Selecione ''flow.dag.yaml'' e visualize o fluxo. Em seguida, selecione o botão + e será possível ver suas ferramentas. Caso não encontre sua ferramenta na lista, será necessário recarregar as janelas para limpar o cache anterior.

    Captura de tela do VS Code mostrando as ferramentas.

Por que minha ferramenta personalizada não está aparecendo na interface do usuário?

Você pode testar seu pacote de ferramentas usando o script a seguir para garantir que empacotou os arquivos YAML da ferramenta e configurou o ponto de entrada da ferramenta do pacote corretamente.

  1. Instale o pacote de ferramentas em seu ambiente conda antes de executar esse script.

  2. Crie um arquivo python em qualquer lugar e copie o seguinte conteúdo nele.

    def test():
    # `collect_package_tools` gathers all tools info using the `package-tools` entry point. This ensures that your package is correctly packed and your tools are accurately collected. 
    from promptflow.core.tools_manager import collect_package_tools
    tools = collect_package_tools()
    print(tools)
if __name__ == "__main__":
    test()

  3. Execute esse script no seu ambiente conda. Isso retornará os metadados de todas as ferramentas instaladas em seu ambiente local e você deverá verificar se suas ferramentas estão listadas.

Por que não consigo carregar o pacote no PyPI?

  • Verifique se o nome de usuário e a senha da sua conta do PyPI foram inseridos corretamente.
  • Se você encontrar um 403 Forbidden Error, provavelmente é devido a um conflito de nomenclatura com um pacote existente. Será necessário escolher um nome diferente. Os nomes dos pacotes devem ser exclusivos no PyPI para evitar confusão e conflitos entre os usuários. Antes de criar um novo pacote, é recomendado pesquisar no PyPI (https://pypi.org/) para verificar se o nome escolhido ainda não está em uso. Se o nome desejado não estiver disponível, considere selecionar um nome alternativo ou uma variação que diferencie claramente o seu pacote do pacote existente.

Próximas etapas