Referência da API OpenAI

Teste

curl https://api.openai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
  "model": "gpt-3.5-turbo",
  "messages": [
    {
      "role": "system",
      "content": "You are a helpful assistant."
    },
    {
      "role": "user",
      "content": "Hello!"
    }
  ]
}'

Interface do agente

Utilização do CloudFlare

官方教程

Base URL

https://api.openai.com/v1

Substituído por

https://gateway.ai.cloudflare.com/v1/[xxx]/[yyy]/openai

Por exemplo, por exemplo

curl https://gateway.ai.cloudflare.com/v1/45a93dd9034ce3d27b263a074d05f09a/ververv/openai/chat/completions \

Definição de interface de chat

官网

Formatear a resposta

官网

Resposta _ Formato

Deve ser um dos text 'ou json _ object'.

A configuração para { "type": "json_object"} habilita o modo JSON, o que garante que a mensagem gerada pelo modelo seja JSON válida.

• • Importante: * * Ao usar o modo JSON, você * * deve instruir o modelo a produzir JSON por meio de uma mensagem do sistema ou do usuário. Sem isso, o modelo pode gerar um fluxo interminável de espaços em branco até que a geração atinja o limite de token, resultando em uma solicitação longa e aparentemente "preso". Note também que o conteúdo da mensagem pode ser parcialmente cortado se finish _ reason="length" , o que indica que a geração excedido max _ tokens ou a conversa excedido o comprimento máximo do contexto.

Chamada de funções / ferramentas

官网

Ferramentas: Lista de ferramentas

Cada ferramenta é um objeto e cada objeto tem

tipo: Atualmente, apenas função é suportada.

Função: Nome, Descrição, Parâmetros

Definição de cada parâmetro:

Nome, tipo de parâmetro, descrição, valores opcionais, quais parâmetros são necessários

Exemplos

• • Solicitação * *

curl https://api.openai.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d '{
  "model": "gpt-3.5-turbo",
  "messages": [
    {
      "role": "user",
      "content": "What is the weather like in Boston?"
    }
  ],
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_current_weather",
        "description": "Get the current weather in a given location",
        "parameters": {
          "type": "object",
          "properties": {
            "location": {
              "type": "string",
              "description": "The city and state, e.g. San Francisco, CA"
            },
            "unit": {
              "type": "string",
              "enum": ["celsius", "fahrenheit"]
            }
          },
          "required": ["location"]
        }
      }
    }
  ],
  "tool_choice": "auto"
}'

• Resposta *

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1699896916,
  "model": "gpt-3.5-turbo-0125",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": null,
        "tool_calls": [
          {
            "id": "call_abc123",
            "type": "function",
            "function": {
              "name": "get_current_weather",
              "arguments": "{\n\"location\": \"Boston, MA\"\n}"
            }
          }
        ]
      },
      "logprobs": null,
      "finish_reason": "tool_calls"
    }
  ],
  "usage": {
    "prompt_tokens": 82,
    "completion_tokens": 17,
    "total_tokens": 99
  }
}

Um grande quadro

{
  "model": "gpt-3.5-turbo",
  "messages": [
    {
      "role": "user",
      "content": "What is the weather like in Boston?"
    }
  ],
  "tools": [ // tool列表，与model同级
    { // 具体某个tool
      "type": "function", // 类型：暂时只支持function
      "function": {
        "name": "get_current_weather",
        "description": "Get the current weather in a given location",
        "parameters": {
          // 更具体定义
        }
      }
    }
  ],
  "tool_choice": "auto" // 选择哪个tool，与model同级
}

Parâmetros

{
  "type": "object",
  "properties": {
    "location": {
      "type": "string",
      "description": "The city and state, e.g. San Francisco, CA"
    },
    "unit": {
      "type": "string",
      "enum": [
        "celsius",
        "fahrenheit"
      ]
    }
  },
  "required": ["location"],
}