O sistema de rastreamento do OpenAI Agents SDK oferece visibilidade sobre fluxos de trabalho de IA, capturando eventos importantes para ajudar desenvolvedores a monitorar e depurar suas aplicações de forma eficaz.
O que é o OpenAI Agents SDK?
O 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. Em 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 da OpenAI (o1, o3-mini, gpt-4o) quanto com modelos de terceiros que possuem APIs compatíveis com a OpenAI.
Principais Recursos do OpenAI Agents SDK
Ferramentas e Extensões Funcionais:
- Chamada de Função: 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 perfeita entre agentes e LLMs
- Transferência de Tarefas: Permite que agentes deleguem tarefas a outros agentes especializados, possibilitando 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 qualidade e adequação das respostas
- Ferramentas de Rastreamento: Funcionalidade de rastreamento integrada que visualiza e monitora todo o fluxo do agente, auxiliando na depuração e otimização
Recursos Amigáveis para o Desenvolvedor:
- Métodos Nativos em Python: Aproveite os recursos da linguagem Python para orquestração e encadeamento de agentes, reduzindo a necessidade de aprender novas abstrações
- Altamente Customizável: Oferece ferramentas personalizadas, tipos de saída estruturados e capacidade de integração com provedores de LLM externos
- Design Leve: Conjunto de primitivas simples, porém poderoso, que exige uma curva de aprendizado mínima
Benefícios do OpenAI Agents SDK
Eficiência no Desenvolvimento
- Simplifica processos de configuração, agiliza o desenvolvimento de aplicações com agentes e reduz a barreira de entrada para o desenvolvimento de agentes de IA
Capacidades Aprimoradas do Sistema:
- Suporta execução de tarefas complexas e colaboração eficiente entre múltiplos agentes
- Cria sistemas colaborativos especializados para resolver problemas complexos
- Integra modelos LLM externos para maior flexibilidade
Segurança e Confiabilidade:
- Guardrails garantem interações seguras com 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 dos agentes
- Melhora a análise de padrões de usuários e a identificação de gargalos
- Aprimora as capacidades de depuração e otimização de fluxos de trabalho
Um Exemplo do OpenAI Agents SDK
Passo 1: Configure o Agente
Inicialize o agente criando um assistente virtual chamado AccountingAssistant com instruções claras para sua funcionalidade.
Passo 2: Integre Ferramentas
Integre ferramentas essenciais, incluindo:
- Ferramenta de Pesquisa na Web: Obter atualizações fiscais.
- Chamadas de API: Analisar demonstrações financeiras.
- Ferramenta de Pesquisa de Arquivos: Localizar documentos relevantes.
Passo 3: Defina Tarefas
Divida o fluxo de trabalho em tarefas específicas:
- Tarefa 1: Obter 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: Execute as Tarefas
Execute as 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: Monitore e Depure
Use ferramentas de rastreamento para monitorar a execução das tarefas e identificar possíveis problemas para depuração.
Como Integrar Novita AI com o OpenAI Agents SDK?
1. Configure seu ambiente Python e instale o SDK Agents.
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 Gratuitos
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 da OpenAI (o1, o3-mini, gpt-4o) e modelos de terceiros com APIs compatíveis com a OpenAI, como a 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 nuvem GPU acessível e confiável para construir e dimensionar.
