O sistema de rastreamento do OpenAI Agents SDK fornece visibilidade nos fluxos de trabalho de IA, capturando eventos importantes para ajudar desenvolvedores a monitorar e depurar suas aplicações de forma eficaz.
O que é OpenAI Agents SDK?
OpenAI Agents SDK é um kit de ferramentas Python que simplifica o desenvolvimento de agentes de IA. Esta evolução pronta para produção do projeto SWARM da OpenAI fornece recursos para construir sistemas de IA inteligentes, colaborativos e seguros. No seu núcleo estão agentes baseados em LLM configuráveis com instruções e ferramentas específicas, suportando funções personalizadas e compatíveis tanto com modelos OpenAI (o1, o3-mini, gpt-4o) quanto com modelos de terceiros que possuem APIs compatíveis com OpenAI.
Principais Recursos do OpenAI Agents SDK
Ferramentas e Extensões Funcionais:
- Chamada de Funções: Converta funções Python em ferramentas usando o decorador
@function_tool, com geração automática de esquemas e validação Pydantic - Loop de Agente Integrado: Gerencia chamadas de ferramentas, feedback de resultados e loops de tarefas para interação contínua entre agentes e LLMs
- Transferência de Tarefas: Permite que agentes deleguem tarefas a outros agentes especializados, possibilitando a colaboração multi-agente
Mecanismos de Segurança e Monitoramento:
- Guardrails: A triagem de entrada previne conteúdo prejudicial, enquanto a validação de saída garante a qualidade e adequação das respostas
- Ferramentas de Rastreamento: Funcionalidade de rastreamento incorporada visualiza e monitora todo o fluxo do agente, auxiliando na depuração e otimização
Recursos Amigáveis ao Desenvolvedor:
- Métodos Nativos em Python: Aproveita os recursos da linguagem Python para orquestração e encadeamento de agentes, reduzindo a necessidade de aprender novas abstrações
- Altamente Personalizável: Fornece ferramentas personalizadas, tipos de saída estruturados e capacidades de integração com provedores LLM externos
- Design Leve: Conjunto simples mas poderoso de primitivas que requer uma curva de aprendizado mínima
Benefícios do OpenAI Agents SDK
Eficiência de Desenvolvimento
- Simplifica processos de configuração, agiliza o desenvolvimento de aplicações de agentes e reduz a barreira de entrada para desenvolvimento de agentes de IA
Capacidades Aprimoradas do Sistema:
- Suporta execução de tarefas complexas e colaboração multi-agente eficiente
- Cria sistemas colaborativos especializados para resolver problemas complexos
- Integra modelos LLM externos para maior flexibilidade
Segurança e Confiabilidade:
- Guardrails garantem interações seguras de IA
- Aumenta a confiabilidade e o comportamento adequado dos sistemas de agentes de IA
- Simplifica a preparação de aplicações de agentes de IA para ambientes de produção
Análise e Otimização:
- O sistema de rastreamento fornece insights sobre o comportamento do agente
- Melhora a análise de padrões de usuário e identificação de gargalos
- Aprimora as capacidades de depuração e otimização de fluxo de trabalho
Um Exemplo do OpenAI Agents SDK
Passo 1: Configurar o Agente
Inicialize o agente criando um assistente virtual chamado AccountingAssistant com instruções claras para sua funcionalidade.
Passo 2: Integrar Ferramentas
Integre ferramentas essenciais, incluindo:
- Ferramenta de Pesquisa na Web: Recuperar atualizações fiscais.
- Chamadas de API: Analisar demonstrativos financeiros.
- Ferramenta de Pesquisa de Arquivos: Localizar documentos relevantes.
Passo 3: Definir Tarefas
Divida o fluxo de trabalho em tarefas específicas:
- Tarefa 1: Recuperar as últimas atualizações fiscais.
- Tarefa 2: Analisar dados financeiros usando uma API.
- Tarefa 3: Gerar relatórios com base nos dados mais recentes.
Passo 4: Executar Tarefas
Execute tarefas sequencialmente ou em paralelo. Por exemplo:
Runner.run_sync(agent, "Generate a report based on the latest tax laws and financial data.")
Passo 5: Monitorar e Depurar
Use ferramentas de rastreamento para monitorar a execução das tarefas e identificar possíveis problemas para depuração.
Como Integrar Novita AI com OpenAI Agents SDK?
1. Configure seu ambiente Python e instale o Agents SDK.
python -m venv env
source env/bin/activate
pip install openai-agents
2. Configure sua chave de API Novita.
Vá para o Console e Obtenha Créditos Grátis
3. Um Exemplo de Handoffs
import os
from openai import AsyncOpenAI
from agents import (
Agent,
Runner,
set_default_openai_api,
set_default_openai_client,
set_tracing_disabled,
)
BASE_URL = "https://api.novita.ai/v3/openai"
API_KEY = os.getenv("NOVITA_API_KEY")
MODEL_NAME = os.getenv("MODEL_NAME")
# Because Novita not support the responses API so we use the chat completions API instead.
set_default_openai_api("chat_completions")
set_default_openai_client(AsyncOpenAI(base_url=BASE_URL, api_key=API_KEY))
# Disable tracing for this example
# Refer to https://openai.github.io/openai-agents-python/tracing/#external-tracing-processors-list to use the custom spans.
set_tracing_disabled(disabled=True)
agent = Agent(name="Assistant",
instructions="You are a helpful assistant", model=MODEL_NAME)
result = Runner.run_sync(
agent, "Write a haiku about recursion in programming.")
print(result.final_output)
# Code within the code,
# Functions calling themselves,
# Infinite loop's dance.
Com capacidades flexíveis de rastreamento, os desenvolvedores podem acompanhar o comportamento dos agentes através de funcionalidades integradas e integrações de terceiros, garantindo melhor desempenho e confiabilidade.
Perguntas Frequentes
Quais modelos LLM posso usar com o OpenAI Agents SDK?
Compatível com modelos OpenAI (o1, o3-mini, gpt-4o) e modelos de terceiros com APIs compatíveis com OpenAI, como Novita AI.
Como o OpenAI Agents SDK lida com a integração de ferramentas?
Converta funções Python em ferramentas usando o decorador @function_tool com geração automática de esquemas e validação Pydantic.
O OpenAI Agents SDK é adequado para ambientes de produção?
Sim, ele inclui recursos de segurança como guardrails, rastreamento abrangente e capacidades de monitoramento.
Novita AI é uma plataforma de nuvem de IA que oferece aos desenvolvedores uma maneira fácil de implantar modelos de IA usando nossa API simples, além de fornecer uma GPU em nuvem acessível e confiável para construir e escalar.
