Como faço para adicionar ferramentas personalizadas na Dify?

Difícil A criação de uma ferramenta personalizada é fornecida, embora seja necessário que essa ferramenta personalizada siga a especificação OpenAPI-Swagger.

Um exemplo de um modelo canônico vazio é mostrado abaixo:

{
      "openapi": "3.1.0",
      "info": {
        "título": "Sem título".
        "description": "Sua especificação OpenAPI",
        "versão": "v1.0.0"
      },
      "servidores": [
        {
          "url": ""
        }
      ],
      "paths": {},
      "componentes": {
        "schemas": {}
      }
    }

Geração da especificação OpenAPI-Swagger

Usamos o chatgpt para me ajudar a converter a chamada curl em um esquema openapi com o seguinte prompt:

Converta o comando de solicitação curl para o esquema json da versão 3.1.0 do openapi sem a mensagem de resposta.

curl --location 'https://cloud.dify.ai/generate_image/'
--header 'Content-Type: application/json'
--data '{"prompt": "Uma gatinha floral fofa, na moda, usando um lenço colorido com um triângulo de bolinhas na cabeça, grande blush, muito fofa, alta saturação, doo-doo fofo, de pelúcia e macio, usando um lenço na cabeça que se choca com o sistema de cores do cheongsam, estilo de feltro de lã, o pescoço com você ecoando a cor do lenço, muito fofo, um buquê de flores nos braços, a metade superior dos retratos do corpo, as poses que lhe são dadas, kawaii, imagem Simples, alta saturação, atmosfera relaxada, qualidade de imagem sedosa, visão média, lente padrão, estilo simples, imagem HD de 32k, fofa, céu azul e fundo de nuvens brancas, sutil"}'


Consulte o exemplo a seguir para ver o esquema json

{
"openapi": "3.1.0",
"info": {
"title": "Get weather data" (Obter dados meteorológicos),
"description": "Recupera os dados meteorológicos atuais de um local.",
"versão": "v1.0.0"
},
"servidores": [
{
"url": ""
}
],
"paths": {},
"componentes": {
"schemas": {}
}
}

Os resultados gerados são os seguintes.

{
  "openapi": "3.1.0",
  "info": {
    "título": "Gerar API de imagem",
    "description": "API para gerar uma imagem com base em um determinado prompt.",
    "versão": "v1.0.0"
  },
  "servidores": [
    {
      "url": "https://cloud.dify.ai"
    }
  ],
  "paths": {
    "/generate_image/": {
      "post": {
        "summary": "Gerar uma imagem com base em um prompt",
        "operationId": "generateImage",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenerateImageRequest"
              }
            }
          }
        },
        "responses": {}
      }
    }
  },
  "componentes": {
    "schemas": {
      "GenerateImageRequest": {
        "type": "object",
        "properties": {
          "prompt": {
            "type": "string",
            "description": "O prompt que descreve a imagem a ser gerada."
          }
        },
        "required": [
          "prompt"
        ]
      }
    }
  }
}