Extensão Baseada em API

{
    "point": "string",  // Ponto de extensão, diferentes módulos podem conter vários pontos de extensão
    "params": {
        ...  // Parâmetros passados para o ponto de extensão de cada módulo
    }
}

{
    ...  // Para o conteúdo retornado pela API, consulte as especificações de design do módulo específico para diferentes pontos de extensão.
}

{
    "point": "ping"
}

{
    "result": "pong"
}

{
    "point": "app.external_data_tool.query",
    "params": {
        "app_id": "61248ab4-1125-45be-ae32-0ce91334d021",
        "tool_variable": "weather_retrieve",
        "inputs": {
            "location": "London"
        },
        "query": "Como está o tempo hoje?"
    }
}

{
    "result": "Cidade: Londres\nTemperatura: 10°C\nSensação Térmica®: 8°C\nQualidade do Ar: Ruim\nDireção do Vento: ENE\nVelocidade do Vento: 8 km/h\nRajadas de Vento: 14 km/h\nPrecipitação: Chuva leve"
}

pip install 'fastapi[all]' uvicorn

from fastapi import FastAPI, Body, HTTPException, Header
from pydantic import BaseModel

app = FastAPI()

class InputData(BaseModel):
    point: str
    params: dict

@app.post("/api/paragraph/receive")
async def paragraph_receive(data: InputData = Body(...), authorization: str = Header(None)):
    """
    Receber dados de consulta de API do Paragraph.
    """
    expected_api_key = "123456"  # TODO Sua chave de API desta API
    auth_scheme, _, api_key = authorization.partition(' ')

    if auth_scheme.lower() != "bearer" or api_key != expected_api_key:
        raise HTTPException(status_code=401, detail="Não autorizado")

    point = data.point

    # para depuração
    print(f"point: {point}")

    if point == "ping":
        return {
            "result": "pong"
        }
    if point == "app.external_data_tool.query":
        return handle_app_external_data_tool_query(params=data.params)
    # elif point == "{nome do ponto}":
        # TODO implementação de outros pontos aqui

    raise HTTPException(status_code=400, detail="Não implementado")

def handle_app_external_data_tool_query(params: dict):
    app_id = params.get("app_id")
    tool_variable = params.get("tool_variable")
    inputs = params.get("inputs")
    query = params.get("query")

    # para depuração
    print(f"app_id: {app_id}")
    print(f"tool_variable: {tool_variable}")
    print(f"inputs: {inputs}")
    print(f"query: {query}")

    # TODO sua implementação de consulta à ferramenta de dados externos aqui,
    # a resposta deve ser um dict com a chave "result", e o valor é o resultado da consulta
    if inputs.get("location") == "London":
        return {
            "result": "Cidade: Londres\nTemperatura: 10°C\nSensação Térmica®: 8°C\nQualidade do Ar: Ruim\nDireção do Vento: ENE\nVelocidade do Vento: 8 km/h\nRajadas de Vento: 14 km/h\nPrecipitação: Chuva leve"
        }
    else:
        return {"result": "Cidade desconhecida"}

{
    "point": "app.external_data_tool.query",
    "params": {
        "app_id": "61248ab4-1125-45be-ae32-0ce91334d021",
        "tool_variable": "weather_retrieve",
        "inputs": {
            "location": "London"
        },
        "query": "Como está o tempo hoje?"
    }
}

{
    "result": "Cidade: Londres\nTemperatura: 10°C\nSensação Térmica®: 8°C\nQualidade do Ar: Ruim\nDireção do Vento: ENE\nVelocidade do Vento: 8 km/h\nRajadas de Vento: 14 km/h\nPrecipitação: Chuva leve"
}

$ unzip /caminho/para/ngrok.zip
$ ./ngrok config add-authtoken seuToken

 $ ./ngrok http [número da porta]