CertiTipsFUNÇÃO DO CRITÉRIO
EspañolEnglishPortuguêsItaliano

O OpenAI Agent Stack

Escolha um nível apropriado de ferramentas de monitoramento e coordenação, agentes especializados e guarrails.

O Responses API conecta sua aplicação com modelos e ferramentas. O Agents SDK organiza o trabalho do agente em seu próprio código. Entender a diferença impede atribuir às tarefas do modelo de execução e controlar que pertencem ao tempo de execução.

Conceitos de Chave

Pense em três níveis: Modelos produção de respostas e propostas de ações Responses API como uma interface para invocá-los com contexto e ferramentas; e... Agents SDK para definir agentes e coordenar seu loop. O módulo estuda esta base de curso, e não todo o catálogo de produtos que pode ser publicado mais tarde.

Usar SDK não significa que OpenAI hospeda automaticamente sua aplicação Python. Seu pedido permanece responsável de sua implantação, integrações, dados e decisões de autorização. A ferramenta hospedada e uma característica de sua infra-estrutura pode aparecer no mesmo fluxo, embora eles funcionam em diferentes ambientes.

Para uma simples solicitação você pode chamada Responses diretamente. Se você precisar de vários passos, você também pode implementar o laço em sua aplicação. O SDK será útil se você estiver interessado em reutilizar coordenação, ferramentas, transferências e guarrails. A escolha depende de quanto controle você precisa e quão lógico você quer manter, e não como uma opção é sempre melhor.

Módulo Objetivos

Respostas e contexto

A solicitação para Responses especifica modelo, entrada e, conforme apropriado, instruções e ferramentas. A saída pode conter texto e outros elementos, incluindo solicitações execução. output_text mais fácil de ler o texto final, mas um integrer deve examinar os elementos relevantes durante a aplicação do laço.

Para conduzir discussões há opções como uma história administrada pela aplicação, previous_response_id Para canalizar respostas e conversas para preservar elementos em uma conversa. Ter um identificador de continuidade não remove limites de contexto, custos ou decisões de retenção. Escolha uma estratégia e preserve os dados que essa estratégia requer. O Guia oficial de conversa de estado Explique suas diferenças.

Agentes, Corredores e Tools

A Agente. reúne uma responsabilidade, instruções, modelo e capacidades. O Corredor. Conduzir o ciclo: invoca o modelo, atende ferramentas ou delegações e retorna um resultado após o seu fim. Na Python, Runner.run É assíncrono e Runner.run_sync serve em um contexto síncrono apropriado. final_output contém o resultado final. O tipo depende de como o agente foi armado.

Uma. ferramenta de função Expanda o código de sua aplicação. O decorador. @function_tool Apreende assinatura, tipos e descrição para representar a capacidade. O modelo solicitações é uma operação com argumentos. O tempo de execução executa a implementação. Uma. ferramenta hospedadacomo uma busca compatível com o modelo escolhido, opera a partir do serviço. Agentes como ferramentas. permite que um agente principal consulte um especialista como uma capacidade fechada e então prepare a resposta.

Os esquemas melhorar a forma de argumentos, mas uma função de reembolso ainda deve verificar responsável, quantidade, estado e duplicatas. A API chave é salva no servidor ou em um ambiente protegido, nunca em público JavaScript de uma página de estudo.

Mão e responsabilidade.

com um DescolagemO controle desse ramo vai para o especialista. com um Gerente. Usando agentes como ferramentas, o principal mantém a responsabilidade pela resposta. Vários atores não são necessários só porque existem várias ferramentas: eles dividem quando as responsabilidades, políticas ou capacidades mudam. O Padrão oficial de orquestração Ele descreve essa distinção.

Exemplo passo a passo

Cria mentalmente um sistema de apoio com triagem, ordens e retornos.

  1. O usuário pergunta: "Onde está meu pedido?" P-204?" Entrada Verificação de validação de alcance e formato.
  2. A triagem identifica intenção e faz uma entrega para o especialista em pedidos.
  3. Aquele agente está se candidatando. consultar_pedido. A infraestrutura verifica o acesso e retorna "em preparação".
  4. O especialista escreve a resposta usando esse resultado, sem afirmar que já foi entregue.
  5. Se o usuário depois de solicitar um reembolso, a política de reembolso e a autorização da ação concreta são aplicadas antes de emitir um reembolso.

A demonstração usa dados fictícios e uma função que só simula a operação. Ordem de teste inexistente, acesso negado e solicitação fora de tópico. Em cada caso deve haver uma resposta controlada e nenhuma operação financeira real.

Vagões e rastros

Entrada, saída e ferramentas têm diferentes alcances. Na SDK, a entrada é aplicada ao primeiro agente da cadeia e ao agente final ao qual a resposta final resulta. Não suponha que se repitam em todos os especialistas. A validação de uma ação sensível é colocada ao lado da ferramenta e uma aprovação pode pausar o fluxo. Verificações paralelas reduzem a latência, mas podem permitir trabalho especulativo, usando o bloqueio execução se necessário. Consulta e monitoramento humano..

No exemplo de suporte, um voucher pode produzir uma saída estruturada como is_support_question: bool, como definido com um modelo Pydantic. Se o resultado não atender à regra, o guarrail pode ativar um Tripwire.O Runner cruza execução com uma exceção que o aplicativo deve gerenciar. Não descubram as operações já realizadas. É por isso que importa quando é válido. O Implementação oficial de guarrails SDK mostra resultado estruturado e modos execução.

O rastro de A mostra etapas, chamadas e resultados disponíveis. Ajuda a distinguir o tempo do modelo, de um API e da validação. Protege os dados registrados e verifica a configuração do layout. Não interprete um traço como um raciocínio interno completo ou sinta que a função mais visível é necessariamente o pescoço da garrafa.

Erros comuns.

Exercício de design.

A membro da equipe deve consultar dois especialistas e colocar seus resultados juntos em um único relatório. O que melhor indica essa responsabilidade?

Solução

Gerente A com especialistas expostos como ferramentas mantém o controle e sintetiza o relatório. A entrega é adequada quando outro especialista tem que cuidar da conversa. Nenhum deles por si só autorizou ações sensível: cada ferramenta mantém suas validações e permissões.

Fontes e revisão

O Introdução oficial a Agents SDK Links definições, execução e ferramentas. Revisar o caso de suporte indicando que configuração pertence ao agente e quão lógico ele deve permanecer na aplicação. A sintaxe exata e as capacidades devem ser verificadas com a versão SDK e o modelo escolhido.