azd ai toolbox create doesn't work with a tool that doesn't need connection or rai_policy

[lindazqli]

a tool without connection (eg web search)

yaml:
description: >
web-search only
tools:

• type: web_search

azd command: azd ai toolbox create wstest --from-file C:\Temp\ws.yaml `
--project-endpoint https://hengyl-aif-wus2.services.ai.azure.com/api/projects/projectcgnp

error: ERROR: invalid YAML in "C:\Temp\ws-only.yaml": yaml: unmarshal errors:
line 3: field tools not found in type cmd.toolboxCreateFile

Suggestion: fix the file and retry; see azd ai toolbox create --help or
azd ai toolbox connection add --help for the supported file shape

exit=1

guardtail/rai policy

yaml:

description: probe v2 policies.rai_config
policies:
rai_config:
name: Microsoft.Default
connections:

• name: mslearn-anon

azd command: azd ai toolbox create wstest --from-file C:\Temp\ws.yaml `
--project-endpoint https://hengyl-aif-wus2.services.ai.azure.com/api/projects/projectcgnp

error: line 2: field policies not found in type cmd.toolboxCreateFile

[lindazqli]

description: probe v2 policies.rai_config
policies:
  rai_config:
    name: Microsoft.Default
connections:
  - name: mslearn-anon

yaml for rai policy

[lindazqli]

description: > 
  web-search only
tools:
  - type: web_search

yaml for built in tool

[lindazqli]

proposed yaml on the high level for toolbox creation:

# Body of POST /toolboxes/{name}/versions  (name is in the URL, not the YAML)
description: Toolbox covering OpenAPI, A2A, MCP, file search, web search,    # opt, ≤512 chars
             code interpreter, AI Search, WorkIQ, FabricIQ.
policies:                       # opt — ToolboxPolicies
  rai_config:                   # opt — RaiConfig (separate model, not shown)
    # ... refer to skills/models.tsp ...
skills: []                      # opt — ToolboxSkill[]; entries: { type: "skill_reference", name, version? }
tools:                          # req — OpenAI.Tool[]
  - ...

detailed tool based yaml:

tools:

  # ──────────────────────────────────────────────────────────────────
  # 1. MCP — OpenAI.MCPTool + Foundry project_connection_id
  # ──────────────────────────────────────────────────────────────────
  - type: mcp
    server_label: github                              # req (OpenAI base)
    server_url: https://api.githubcopilot.com/mcp     # opt (OpenAI base)
    headers:                                          # opt (OpenAI base)
      X-Tenant: contoso
    allowed_tools:                                    # opt (OpenAI base) — string[] or {tool_names:[]}
      - search_issues
      - get_issue
    require_approval: never                           # opt (OpenAI base) — "always" | "never" | {always:{tool_names},never:{tool_names}}
    project_connection_id: ".../connections/my-mcp"   # opt (Foundry add-on)
    tool_configs:                                     # opt (Foundry: ToolConfigExtension)
      "*":
        pin: true
        additional_search_text: "issues, prs, repos"

  # ──────────────────────────────────────────────────────────────────
  # 2. OpenAPI — OpenApiTool
  # ──────────────────────────────────────────────────────────────────
  - type: openapi
    openapi:                                          # req — OpenApiFunctionDefinition
      name: orders_api                                # req
      description: Customer orders API                # opt
      spec: { openapi: "3.0.0", info: {...}, paths: {...} }   # req — JSON Schema object
      auth:                                           # req — OpenApiAuthDetails (discriminated by .type)
        type: project_connection                      # anonymous | project_connection | managed_identity
        security_scheme:
          project_connection_id: ".../connections/orders-api"
      default_params: [orgId, region]                 # opt — string[]
    tool_configs:                                     # opt
      "*": { pin: false }

  # ──────────────────────────────────────────────────────────────────
  # 3. A2A — A2APreviewTool
  # ──────────────────────────────────────────────────────────────────
  - type: a2a_preview
    project_connection_id: ".../connections/my-a2a"   # opt
    base_url: https://agent.example.com               # opt — url
    agent_card_path: /.well-known/agent-card.json     # opt — default shown
    tool_configs: {}                                  # opt

  # ──────────────────────────────────────────────────────────────────
  # 4. Azure AI Search — AzureAISearchTool
  # ──────────────────────────────────────────────────────────────────
  - type: azure_ai_search
    azure_ai_search:                                  # req — AzureAISearchToolResource
      indexes:                                        # req — maxItems 1; AISearchIndexResource[]
        - project_connection_id: ".../connections/my-search"   # opt — IndexResource
          index_name: products                        # opt — IndexResource
          query_type: vector_semantic_hybrid          # opt — simple | semantic | vector | vector_simple_hybrid | vector_semantic_hybrid
          top_k: 5                                    # opt
          filter: "category eq 'docs'"                # opt
          index_asset_id: ""                          # opt
    name: docs-search                                 # opt
    description: Product docs vector search           # opt
    tool_configs: {}                                  # opt

  # ──────────────────────────────────────────────────────────────────
  # 5. Web Search — OpenAI.WebSearchTool + Foundry custom_search_configuration
  # ──────────────────────────────────────────────────────────────────
  - type: web_search
    # OpenAI base fields:
    search_context_size: medium                       # opt (OpenAI base) — low | medium | high
    user_location:                                    # opt (OpenAI base)
      type: approximate
      country: US
      city: Seattle
    # Foundry extension (optional; presence = "Bing custom search" variant):
    custom_search_configuration:                      # opt — WebSearchConfiguration
      project_connection_id: ".../connections/my-bing-custom"   # req inside block
      instance_name: docs-config                      # req inside block
    name: web                                         # opt
    description: Web search grounding                 # opt
    tool_configs: {}                                  # opt

  # ──────────────────────────────────────────────────────────────────
  # 6. Code Interpreter — OpenAI.CodeInterpreterTool + Foundry extension
  # ──────────────────────────────────────────────────────────────────
  - type: code_interpreter
    container:                                        # req (OpenAI base) — string | { type: "auto", file_ids?: [] }
      type: auto
      file_ids: []                                    # opt
    name: code                                        # opt
    description: Sandboxed Python                     # opt
    tool_configs: {}                                  # opt

  # ──────────────────────────────────────────────────────────────────
  # 7. File Search — OpenAI.FileSearchTool + Foundry extension
  # ──────────────────────────────────────────────────────────────────
  - type: file_search
    vector_store_ids: [vs_abc123]                     # req (OpenAI base) — string[]
    max_num_results: 20                               # opt (OpenAI base)
    ranking_options:                                  # opt (OpenAI base)
      ranker: auto                                    # auto | default-2024-08-21
      score_threshold: 0.0
    filters:                                          # opt (OpenAI base) — compound filter object
      type: eq
      key: category
      value: docs
    name: files                                       # opt
    description: Search uploaded files                # opt
    tool_configs: {}                                  # opt

  # ──────────────────────────────────────────────────────────────────
  # 8. WorkIQ — WorkIQPreviewTool
  # ──────────────────────────────────────────────────────────────────
  - type: work_iq_preview
    project_connection_id: ".../connections/my-workiq"   # req
    name: work-iq                                     # opt
    description: WorkIQ enterprise search             # opt
    tool_configs: {}                                  # opt

  # ──────────────────────────────────────────────────────────────────
  # 9. FabricIQ — FabricIQPreviewTool
  # ──────────────────────────────────────────────────────────────────
  - type: fabric_iq_preview
    project_connection_id: ".../connections/ContosoCustomerLoyalty3"   # req
    server_label: contoso                             # opt
    server_url: https://fabric.example.com            # opt — overrides URL from project connection
    require_approval: always                          # opt — default "always"; same shape as MCP require_approval
    tool_configs: {}                                  # opt

  # ──────────────────────────────────────────────────────────────────
  # 10. Toolbox Search — ToolboxSearchPreviewTool
  # When present, tools with tool_configs.pin=false are hidden from
  # tools/list and are only discoverable via this tool at runtime.
  # ──────────────────────────────────────────────────────────────────
  - type: toolbox_search_preview