ComposioHQ/OpenAI-Automation

Automação OpenAI

Automatize seus fluxos de trabalho da API OpenAI – gere texto com a API de Respostas (incluindo entradas multimodais de imagem+texto e saídas JSON estruturadas), crie embeddings para busca e clustering, gere imagens com modelos DALL‑E e GPT Image, e liste modelos disponíveis.

Documentação do Toolkit: composio.dev/toolkits/openai

---

Configuração

1. Adicione o servidor MCP Composio ao seu cliente: https://rube.app/mcp
2. Conecte sua conta OpenAI quando solicitado (autenticação por chave de API)
3. Comece a usar os fluxos de trabalho abaixo

---

Fluxos de Trabalho Principais

1. Gerar uma Resposta (Texto, Multimodal, Estruturada)

Use OPENAI_CREATE_RESPONSE para respostas únicas de modelo, incluindo análise de texto, imagem, OCR e saídas JSON estruturadas.

Ferramenta: OPENAI_CREATE_RESPONSE
Entradas:
  - model: string (obrigatório) – ex.: "gpt-5", "gpt-4o", "o3-mini"
  - input: string | array (obrigatório)
    Simples: "Explique computação quântica"
    Multimodal: [
      { role: "user", content: [
        { type: "input_text", text: "O que há nesta imagem?" },
        { type: "input_image", image_url: { url: "https://..." } }
      ]}
    ]
  - temperature: número (0-2, opcional – não suportado com modelos de raciocínio)
  - max_output_tokens: inteiro (opcional)
  - reasoning: { effort: "none" | "minimal" | "low" | "medium" | "high" }
  - text: objeto (configuração de saída estruturada)
    - format: { type: "json_schema", name: "...", schema: {...}, strict: true }
  - tools: array (function, code_interpreter, file_search, web_search)
  - tool_choice: "auto" | "none" | "required" | { type: "function", function: { name: "..." } }
  - store: booleano (false para desativar destilação de modelo)
  - stream: booleano

Exemplo de saída estruturada: Defina text.format como { type: "json_schema", name: "persona", schema: { type: "object", properties: { nome: { type: "string" }, idade: { type: "integer" } }, required: ["nome", "idade"], additionalProperties: false }, strict: true }.

2. Criar Embeddings

Use OPENAI_CREATE_EMBEDDINGS para busca vetorial, clustering, recomendações e pipelines RAG.

Ferramenta: OPENAI_CREATE_EMBEDDINGS
Entradas:
  - input: string | string[] | int[] | int[][] (obrigatório) – máx. 8192 tokens, máx. 2048 itens
  - model: string (obrigatório) – "text-embedding-3-small", "text-embedding-3-large", "text-embedding-ada-002"
  - dimensions: inteiro (opcional, apenas para text-embedding-3 e posteriores)
  - encoding_format: "float" | "base64" (padrão "float")
  - user: string (opcional, ID do usuário final para monitoramento de abuso)

3. Gerar Imagens

Use OPENAI_CREATE_IMAGE para criar imagens a partir de descrições textuais usando modelos GPT Image ou DALL‑E.

Ferramenta: OPENAI_CREATE_IMAGE
Entradas:
  - model: string (obrigatório) – "gpt-image-1", "gpt-image-1.5", "dall-e-3", "dall-e-2"
  - prompt: string (obrigatório) – máx. 32.000 caracteres (GPT Image), 4.000 (DALL‑E 3), 1.000 (DALL‑E 2)
  - size: "1024x1024" | "1536x1024" | "1024x1536" | "auto" | "256x256" | "512x512" | "1792x1024" | "1024x1792"
  - quality: "standard" | "hd" | "auto" | "high" | "medium" | "low"
  - n: inteiro (1-10; DALL‑E 3 suporta apenas n=1)
  - background: "transparent" | "opaque" | "auto" (apenas modelos GPT Image)
  - style: "vivid" | "natural" (apenas DALL‑E 3)
  - user: string (opcional)

4. Listar Modelos Disponíveis

Use OPENAI_LIST_MODELS para descobrir quais modelos estão acessíveis com sua chave de API.

Ferramenta: OPENAI_LIST_MODELS
Entradas: (nenhuma)

---

Armadilhas Conhecidas

Armadilha	Detalhe
Descontinuação do DALL‑E	DALL‑E 2 e DALL‑E 3 estão obsoletos e deixarão de ser suportados em 05/12/2026. Prefira modelos GPT Image.
DALL‑E 3 apenas imagem única	OPENAI_CREATE_IMAGE com DALL‑E 3 suporta apenas n=1. Use modelos GPT Image ou DALL‑E 2 para múltiplas imagens.
Limites de tokens para embeddings	A entrada não pode exceder 8.192 tokens por item e 2.048 itens por lote para modelos de embedding.
Restrições de modelos de raciocínio	temperature e top_p não são suportados com modelos de raciocínio (o3-mini, etc.). Use reasoning.effort em vez disso.
Modo estrito de saída estruturada	Quando strict: true no formato json_schema, TODAS as propriedades do esquema devem estar listadas no array required.
Comprimento do prompt varia por modelo	Os comprimentos máximos do prompt de imagem diferem: 32.000 (GPT Image), 4.000 (DALL‑E 3), 1.000 (DALL‑E 2).

---

Referência Rápida

Slug da Ferramenta	Descrição
OPENAI_CREATE_RESPONSE	Gera respostas textuais/multimodais com suporte a saída estruturada
OPENAI_CREATE_EMBEDDINGS	Cria embeddings de texto para busca, clustering e RAG
OPENAI_CREATE_IMAGE	Gera imagens a partir de descrições textuais
OPENAI_LIST_MODELS	Lista todos os modelos disponíveis para sua chave de API

---

Desenvolvido por Composio