O guia completo das ferramentas de personalização da Dify, da criação à implantação

Ampliando os recursos de IA: um guia completo para criar e implantar ferramentas de personalização da Dify

Grandes modelos de linguagem são poderosos por si só, mas seu poder é realmente liberado quando conectados a dados e serviços do mundo real. Seja para consultar as informações logísticas mais recentes, acessar a base de conhecimento interna de uma empresa ou invocar uma interface específica de análise de dados, esse recurso de conectividade é fundamental para a criação de aplicativos práticos de IA. E é exatamente isso que Dify O valor do recurso "Custom Tools" (Ferramentas personalizadas) na plataforma: ele oferece um caminho claro para que os desenvolvedores incorporem qualquer uma das ferramentas externas de desenvolvimento. API Integração perfeita que capacita a IA a resolver problemas específicos do domínio.

A seguir, detalharemos passo a passo como o Dify Crie e entre em operação com uma ferramenta personalizada em

Etapa 1: Definir o projeto - Escrever a descrição da interface da API

deixar Dify A compreensão de sua ferramenta começa com o fornecimento de um "manual de instruções", ou seja API Descrição da interface. Esse arquivo de descrição informa à plataforma: o que a sua ferramenta pode fazer, como chamá-la e quais parâmetros são necessários.

Atualmente.Dify Oferece suporte a dois dos líderes do setor API Descreva a especificação:

• OpenAPI (Swagger). Um sistema amplamente adotado API Descrevendo o idioma que é o moderno RESTful API Os padrões factuais da
• Plug-in do ChatGPT. cumprir com OpenAI para seu ecossistema de plug-ins.

Você pode definir diretamente o JSON talvez YAML conteúdo de descrição de formato para colar na caixa de entrada, ou você pode fornecer um URL Endereço.Dify será buscado e analisado automaticamente.

Etapa 2: Importação e validação

Depois de importar o arquivo de descrição, oDify analisará automaticamente seu conteúdo, identificando todas as ferramentas contidas no API Pontos de extremidade. A plataforma listará claramente os caminhos para cada interface (por exemplo /weather), metodologia de solicitação (GET / POST) e os parâmetros de entrada necessários (como city).

Essa é uma parte fundamental da validação. Você pode testar uma ferramenta reconhecida diretamente na interface, inserir parâmetros e ver os resultados retornados para garantir que ela funcione antes de integrá-la a um aplicativo de IA.

Etapa 3: Configurar o controle de acesso - Defina o método de autenticação

Depois de definir a ferramenta, você precisa decidir quem pode usá-la. Isso é feito configurando a Autenticação, que é como configurar seu API O serviço é fechado.

Dify São fornecidos dois tipos principais de autenticação:

• Sem autorização. Acessível publicamente, qualquer pessoa ou aplicativo pode chamar a ferramenta diretamente sem nenhuma credencial. Ideal para serviços públicos e gratuitos.
• Autenticação de chave de API. O chamador deve fornecer uma chave predefinida na solicitação (API Key). Isso é para proteger os usuários privados ou pagos API prática padrão para garantir que somente usuários autorizados tenham acesso.

Por exemplo, se você selecionar "sem autenticação" para um verificador meteorológico, todos poderão usá-lo; se você selecionar "sem autenticação", todos poderão usá-lo; se você selecionar "sem autenticação", todos poderão usá-lo; se você selecionar "sem autenticação", todos poderão usá-lo.API Key", o usuário teria que obter a chave antes de poder verificar o clima.

Etapa 4: ativar o serviço - colocar a ferramenta em execução na nuvem

existir Dify Quando a plataforma é configurada conforme descrito acima, a ferramenta é apenas "registrada". Para que a IA possa de fato chamá-la, a ferramenta por trás do API O serviço deve ser implantado na Internet, ter um acesso público URL.

Você tem duas opções principais de como implantá-los, cada uma voltada para usuários com diferentes formações técnicas.

Opção 1: Caminho rápido para zero servidores - dify-tools-worker

Para os desenvolvedores que não querem gerenciar servidores ou não estão familiarizados com o desenvolvimento de back-end, oDify Oficialmente, há um arquivo chamado dify-tools-worker O projeto de código aberto.

Ele se baseia em Cloudflare Workers um poderoso ambiente de computação sem servidor (serverless) que permite que você execute códigos sem precisar comprar e configurar um servidor.

Vantagens de usar esse programa:

• Gera automaticamente um arquivo que atende aos requisitos de OpenAPI Especificação da documentação da interface.
• Implementação rápida a um custo muito baixo (Cloudflare Workers (Fornecimento de créditos gratuitos).
• Você obterá um endereço de serviço on-line e um endereço de documento, como https://difytoolsworker.yourname.workers.dev/docO último pode ser usado diretamente no Dify A ferramenta é importada para o

Essa solução é perfeita para validar ideias rapidamente e entrar em operação.

Opção 2: Vias especializadas com controle total - FastAPI

Se você for Python Os desenvolvedores, ou aqueles que desejam ter controle total sobre o serviço, usam o FastAPI A estrutura se constrói e se implementa como uma opção mais profissional.

FastAPI é um sistema moderno e de alto desempenho Python Web um de seus maiores destaques é aGeração automática de documentação interativa de API.

Ele tem um fluxo de trabalho simples:

1. despesa ou gasto Python Escreva seu API Lógica.
2. FastAPI será criado automaticamente quando você executar o serviço OpenAPI Documentos compatíveis.

Um exemplo simples da FastAPI:

from fastapi import FastAPI
app = FastAPI()
@app.get("/hello")
def say_hello(name: str):
return {"message": f"Hello, {name}!"}

Depois de iniciar esse serviço, você pode acessar a documentação gerada automaticamente no seguinte endereço:

• http://localhost:8000/docs: Swagger UI Documentação interativa em um formato que pode ser testado diretamente.
• http://localhost:8000/openapi.json: Original OpenAPI JSON Descreva o arquivo.

Tudo o que você precisa fazer é colocar o seguinte FastAPI O aplicativo é implantado em qualquer servidor de nuvem ou plataforma PaaS e, em seguida, o aplicativo é gerado on-line. /openapi.json O endereço é fornecido para DifyA importação de ferramentas pode ser feita em um piscar de olhos. Essa solução oferece a você o máximo de flexibilidade e escalabilidade.