1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41import OpenAI from "openai";

const client = new OpenAI();

const session = await client.beta.agents.sessions.create({
 agent: {
 model: "gpt-6-astra",
 instructions:
 "Use the OpenAI documentation MCP and web search to answer technical questions accurately. Delegate independent research tasks to subagents when useful.",
 tools: [
 { type: "programmatic_tool_calling" },
 {
 type: "mcp",
 server_label: "openai_docs",
 transport: {
 type: "http",
 server_url: "https://developers.openai.com/mcp",
 },
 },
 { type: "web_search" },
 ],
 multi_agent: { enabled: true, max_concurrent_subagents: 4 },
 },
 environment: {
 type: "self_hosted",
 workspace_directory: "/workspace",
 capability_directories: ["/workspace/capabilities/skills"],
 },
 input: [
 {
 role: "user",
 content: [
 {
 type: "input_text",
 text: "Research how to connect an MCP server to an OpenAI agent, check for recent updates, and summarize the recommended setup.",
 },
 ],
 },
 ],
});
console.log(session.id);1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40from openai import OpenAI

client = OpenAI()

session = client.beta.agents.sessions.create(
 agent={
 "model": "gpt-6-astra",
 "instructions": "Use the OpenAI documentation MCP and web search to answer technical questions accurately. Delegate independent research tasks to subagents when useful.",
 "tools": [
 {"type": "programmatic_tool_calling"},
 {
 "type": "mcp",
 "server_label": "openai_docs",
 "transport": {
 "type": "http",
 "server_url": "https://developers.openai.com/mcp",
 },
 },
 {"type": "web_search"},
 ],
 "multi_agent": {"enabled": True, "max_concurrent_subagents": 4},
 },
 environment={
 "type": "self_hosted",
 "workspace_directory": "/workspace",
 "capability_directories": ["/workspace/capabilities/skills"],
 },
 input=[
 {
 "role": "user",
 "content": [
 {
 "type": "input_text",
 "text": "Research how to connect an MCP server to an OpenAI agent, check for recent updates, and summarize the recommended setup.",
 }
 ],
 }
 ],
)
print(session.id)1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23import (
	"context"
	"fmt"
	"github.com/openai/openai-go/v3"
)

ctx := context.Background()
client := openai.NewClient()
session, err := client.Beta.Agents.Sessions.New(ctx, openai.BetaAgentSessionNewParams{Agent: openai.BetaAgentSessionNewParamsAgent{Model: openai.String("gpt-6-astra"),
	Instructions: openai.String("Use the OpenAI documentation MCP and web search to answer technical questions accurately. Delegate independent research tasks to subagents when useful."),
	Tools: []openai.AgentToolParamUnion{openai.AgentToolParamUnion{OfParamProgrammaticToolCalling: &openai.AgentToolParamProgrammaticToolCalling{}},
 openai.AgentToolParamUnion{OfParamMcp: &openai.AgentToolParamMcp{ServerLabel: "openai_docs",
 Transport: openai.McpTransportParamUnion{OfParamHTTP: &openai.McpTransportParamHTTP{ServerURL: "https://developers.openai.com/mcp"}}}},
 openai.AgentToolParamUnion{OfParamWebSearch: &openai.AgentToolParamWebSearch{}}},
	MultiAgent: openai.MultiAgentConfigParam{Enabled: true,
 MaxConcurrentSubagents: openai.Int(4)}},
	Environment: openai.EnvironmentParamUnion{OfParamSelfHosted: &openai.EnvironmentParamSelfHosted{WorkspaceDirectory: "/workspace",
 CapabilityDirectories: []string{"/workspace/capabilities/skills"}}},
	Input: openai.BetaAgentSessionNewParamsInputUnion{OfArrayOfInputMessages: []openai.AgentSessionInputMessageParam{openai.AgentSessionInputMessageParam{Content: []openai.InputContentParamUnion{openai.InputContentParamUnion{OfParamInputText: &openai.InputContentParamInputText{Text: "Research how to connect an MCP server to an OpenAI agent, check for recent updates, and summarize the recommended setup."}}}}}}})
if err != nil {
	panic(err)
}
fmt.Println(session.ID)1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.beta.agents.AgentToolParam;
import com.openai.models.beta.agents.EnvironmentParam;
import com.openai.models.beta.agents.McpTransportParam;
import com.openai.models.beta.agents.MultiAgentConfigParam;
import com.openai.models.beta.agents.sessions.SessionCreateParams;
import java.util.List;

OpenAIClient client = OpenAIOkHttpClient.fromEnv();
var session =
 client
 .beta()
 .agents()
 .sessions()
 .create(
 SessionCreateParams.builder()
 .agent(
 SessionCreateParams.Agent.builder()
 .model("gpt-6-astra")
 .instructions(
 "Use the OpenAI documentation MCP and web search to answer"
 + " technical questions accurately. Delegate independent"
 + " research tasks to subagents when useful.")
 .addTool(AgentToolParam.ProgrammaticToolCalling.builder().build())
 .addTool(
 AgentToolParam.Mcp.builder()
 .serverLabel("openai_docs")
 .transport(
 McpTransportParam.Http.builder()
 .serverUrl("https://developers.openai.com/mcp")
 .build())
 .build())
 .addTool(AgentToolParam.WebSearch.builder().build())
 .multiAgent(
 MultiAgentConfigParam.builder()
 .enabled(true)
 .maxConcurrentSubagents(4L)
 .build())
 .build())
 .environment(
 EnvironmentParam.SelfHosted.builder()
 .workspaceDirectory("/workspace")
 .capabilityDirectories(List.of("/workspace/capabilities/skills"))
 .build())
 .input(
 "Research how to connect an MCP server to an OpenAI agent, check for recent"
 + " updates, and summarize the recommended setup.")
 .build());
System.out.println(session.id());1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21require "openai"

client = OpenAI::Client.new

session = client.beta.agents.sessions.create(agent: {model: "gpt-6-astra",
 instructions: "Use the OpenAI documentation MCP and web search to answer technical questions accurately. Delegate independent research tasks to subagents when useful.",
 tools: [{type: "programmatic_tool_calling"},
 {type: "mcp",
 server_label: "openai_docs",
 transport: {type: "http",
 server_url: "https://developers.openai.com/mcp"}},
 {type: "web_search"}],
 multi_agent: {enabled: true,
 max_concurrent_subagents: 4}},
 environment: {type: "self_hosted",
 workspace_directory: "/workspace",
 capability_directories: ["/workspace/capabilities/skills"]},
 input: [{role: "user",
 content: [{type: "input_text",
 text: "Research how to connect an MCP server to an OpenAI agent, check for recent updates, and summarize the recommended setup."}]}])
puts session.id1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46curl -sS -X POST "https://api.openai.com/v1/agents/sessions" \
 -H "OpenAI-Beta: agents=v1" \
 -H "Authorization: Bearer $OPENAI_API_KEY" \
 -H "Content-Type: application/json" \
 -d '{
 "agent": {
 "model": "gpt-6-astra",
 "instructions": "Use the OpenAI documentation MCP and web search to answer technical questions accurately. Delegate independent research tasks to subagents when useful.",
 "tools": [
 {
 "type": "programmatic_tool_calling"
 },
 {
 "type": "mcp",
 "server_label": "openai_docs",
 "transport": {
 "type": "http",
 "server_url": "https://developers.openai.com/mcp"
 }
 },
 {
 "type": "web_search"
 }
 ],
 "multi_agent": {
 "enabled": true,
 "max_concurrent_subagents": 4
 }
 },
 "environment": {
 "type": "self_hosted",
 "workspace_directory": "/workspace",
 "capability_directories": ["/workspace/capabilities/skills"]
 },
 "input": [
 {
 "role": "user",
 "content": [
 {
 "type": "input_text",
 "text": "Research how to connect an MCP server to an OpenAI agent, check for recent updates, and summarize the recommended setup."
 }
 ]
 }
 ]
 }'