Home Explore Help
Register Sign In
wxcz_admin
/
agency-swarm-cn-git
1
0
Fork 0
Files Issues 0 Pull Requests 0 Wiki
Tree: 4066b1d310
Branches Tags
agency-swarm-cn...
/
docs
/
core-framework
/
agents
/
built-in-tools.mdx

built-in-tools.mdx 2.3 KB
History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354 
  1. ---
    2. 

  2. title: "Built-in Tools"
    3. 

  3. description: "Learn how to use built-in tools in Agency Swarm."
    4. 

  4. icon: "wrench"
    5. 

  5. ---
    6. 

  6. In the latest version, Agency Swarm leverages tools from the [Agents SDK](https://openai.github.io/openai-agents-python/ref/tool/). This provides access to a comprehensive set of production-ready tools maintained by OpenAI.
    7. 

  7. 

  8. ## Available Tools
    9. 

  9. 

  10. The agents SDK provides the following built-in tools:
    11. 

  11. 

  12. ### Hosted Tools
    13. 

  13. 

  14. - **`WebSearchTool`** - Lets an agent search the web
    15. 

  15. - **`FileSearchTool`** - Allows retrieving information from your OpenAI Vector Stores
    16. 

  16. - **`ComputerTool`** - Allows automating computer use tasks
    17. 

  17. - **`CodeInterpreterTool`** - Lets the LLM execute code in a sandboxed environment
    18. 

  18. - **`ImageGenerationTool`** - Generates images from a prompt
    19. 

  19. - **`LocalShellTool`** - Runs shell commands on your machine
    20. 

  20. 

  21. ### Function Tools
    22. 

  22. 

  23. - **`FunctionTool`** - Custom function-based tools using the `@function_tool` decorator
    24. 

  24. 

  25. ### MCP (Model Context Protocol) Tools
    26. 

  26. 

  27. - **`HostedMCPTool`** - Exposes a remote MCP server's tools to the model
    28. 

  28. 

  29. **When to use each tool:**
    30. 

  30. 

  31. - **Web Search**: Real-time information retrieval, current events, up-to-date data
    32. 

  32. - **File Search**: Enriching agent knowledge, reducing hallucinations, querying documents
    33. 

  33. - **Computer Tool**: Automating computer use tasks, UI interactions, testing applications
    34. 

  34. - **Code Interpreter**: Data analysis, calculations, executing code in a sandboxed environment
    35. 

  35. - **Image Generation**: Creating visual content, illustrations, design assets from prompts
    36. 

  36. - **Local Shell**: System administration, file operations, running shell commands
    37. 

  37. - **Function Tool**: Creating custom tools with specific business logic using Python functions
    38. 

  38. - **Hosted MCP Tool**: Accessing tools from remote Model Context Protocol servers
    39. 

  39. 

  40. ### WebSearchTool Sources (all checked URLs)
    41. 

  41. 

  42. ```python
    43. 

  43. from agency_swarm import Agent, WebSearchTool
    44. 

  44. 

  45. agent = Agent(
    46. 

  46.     name="ResearchAgent",
    47. 

  47.     instructions="Search the web and summarize the best sources.",
    48. 

  48.     tools=[WebSearchTool()],
    49. 

  49. )
    50. 

  50. ```
    51. 

  51. 

  52. Use `include_web_search_sources=False` if you do not want source URLs in web-search tool calls.
    53. 

  53. 

  54. For detailed documentation and additional configuration options, refer to the [agents SDK tool documentation](https://openai.github.io/openai-agents-python/ref/tool/).
    55.