Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Este guia orienta você na criação de um agente, na configuração de um ambiente, na inicialização de uma sessão e no streaming de respostas do agente.
| Conceito | Descrição |
|---|---|
| Agent (Agente) | O modelo, prompt do sistema, ferramentas, servidores MCP e skills |
| Environment (Ambiente) | Configuração de onde as sessões são executadas: um sandbox em nuvem gerenciado pela Anthropic ou um sandbox auto-hospedado em sua própria infraestrutura |
| Session (Sessão) | Uma instância de agente em execução dentro de um ambiente, realizando uma tarefa específica e gerando saídas |
| Events (Eventos) | Mensagens trocadas entre sua aplicação e o agente (turnos do usuário, resultados de ferramentas, atualizações de status) |
brew install anthropics/tap/antVerifique a instalação:
ant --versionpip install anthropicDefina sua chave de API como uma variável de ambiente:
export ANTHROPIC_API_KEY="your-api-key-here"Crie um agente
Crie um agente que define o modelo, o prompt do sistema e as ferramentas disponíveis.
AGENT_ID=$(ant beta:agents create --transform id --raw-output < coding-assistant.agent.yaml)
echo "Agent ID: $AGENT_ID"name: Coding Assistant
model:
id: claude-opus-5
system: You are a helpful coding assistant. Write clean, well-documented code.
tools:
- type: agent_toolset_20260401O tipo de ferramenta agent_toolset_20260401 habilita o conjunto completo de ferramentas de agente pré-construídas (bash, operações de arquivo, busca na web e mais). Consulte Ferramentas para a lista completa e opções de configuração por ferramenta.
Salve o agent.id retornado. Você o referenciará em cada sessão que criar.
Crie um ambiente
Um ambiente define o sandbox onde seu agente é executado.
ENVIRONMENT_ID=$(ant beta:environments create --transform id --raw-output < quickstart.environment.yaml)
echo "Environment ID: $ENVIRONMENT_ID"name: quickstart-env
config:
type: cloud
networking:
type: unrestrictedSalve o environment.id retornado. Você o referenciará em cada sessão que criar.
Inicie uma sessão
Crie uma sessão que referencia seu agente e ambiente.
session = client.beta.sessions.create(
agent=agent.id,
environment_id=environment.id,
title="Quickstart session",
)
print(f"Session ID: {session.id}")Envie uma mensagem e faça streaming da resposta
Abra um stream, envie um evento de usuário e, em seguida, processe os eventos conforme eles chegam:
with client.beta.sessions.events.stream(session.id) as stream:
# Envia a mensagem do usuário após o stream abrir
client.beta.sessions.events.send(
session.id,
events=[
{
"type": "user.message",
"content": [
{
"type": "text",
"text": "Create a Python script that generates the first 20 Fibonacci numbers and saves them to fibonacci.txt",
},
],
},
],
)
# Processa eventos de streaming
for event in stream:
match event.type:
case "agent.message":
for block in event.content:
print(block.text, end="")
case "agent.tool_use":
print(f"\n[Using tool: {event.name}]")
case "session.status_idle":
print("\n\nAgent finished.")
breakO agente escreve um script Python, executa-o no sandbox e verifica se o arquivo de saída foi criado. Sua saída será semelhante a esta:
I'll create a Python script that generates the first 20 Fibonacci numbers and saves them to a file.
[Using tool: write]
[Using tool: bash]
The script ran successfully. Let me verify the output file.
[Using tool: bash]
fibonacci.txt contains the first 20 Fibonacci numbers (0 through 4181).
Agent finished.Quando você envia um evento de usuário, o Claude Managed Agents:
session.status_idle quando não tem mais nada a fazer.Cada um destes quickstarts combina o Claude Managed Agents com um framework de chat popular para criar um aplicativo completo e executável. Em cada um, o framework renderiza a interface de chat enquanto uma sessão gerenciada executa o loop do agente no lado do servidor: a sessão mantém a transcrição, executa ferramentas em um sandbox e faz streaming de eventos que o front end renderiza.
Um analista de pesquisa em um chat de navegador construído com o Chat SDK da Vercel. Cada conversa é uma sessão persistente que faz streaming de sua resposta enquanto um feed ao vivo mostra as chamadas de ferramenta. Trocar o adaptador do Chat SDK move o mesmo handler para Slack, Teams, Discord ou WhatsApp.
Um analista de planilhas em um chat construído a partir de primitivas do assistant-ui. As sessões são a lista de threads, um reducer transforma o log de eventos da sessão em mensagens e cards de ferramenta, e cada comando bash renderiza um gate inline de Permitir/Negar antes de ser executado.
Um assistente de finanças pessoais em um chat do CopilotKit. O adaptador AG-UI para Claude Managed Agents mapeia cada thread de chat para uma sessão gerenciada e faz streaming de respostas token por token, e ferramentas personalizadas renderizam gráficos interativos inline na conversa.
Crie configurações de agente reutilizáveis e versionadas
Personalize configurações de rede e sandbox
Habilite ferramentas específicas para seu agente
Trate eventos e direcione o agente durante a execução
Execute seu agente em um agendamento cron recorrente
Destile um corpus de documentos uma única vez em uma wiki de conhecimento e, em seguida, responda a perguntas repetidas a partir dela por uma fração do custo
Was this page helpful?