Tools
What are Tools?
Tools are the capabilities that YEOS uses to answer your questions. Think of them as specialized skills that can be switched on or off depending on what your team needs.
When you ask a question, YEOS decides which tools to use and in what order. Some tools are always active because they form the core of how YEOS searches your documents. Other tools, like web fetching, can be enabled or disabled based on your preferences.
By giving you control over which tools are available, YEOS lets you balance functionality against simplicity. If your team only needs to search internal documents, you can disable web fetching. If you want to pull in live data from the internet, you can enable it with safe defaults.
Always On
The following tools are always active and cannot be disabled. They form the foundation of how YEOS searches and understands your documents.
Search Knowledge Base
This is the core search tool. Whenever you ask a question, YEOS uses it to find the most relevant sections from your uploaded documents. It looks for content that matches the meaning of your question, not just exact word matches.
How it works
When you type a question, YEOS breaks it down into concepts and searches your document library for sections that contain related ideas. The results are ranked by relevance, so the most likely answers appear first.
When to use it
Use this when you want to find specific information buried in your documents. For example, "What is our refund policy?" or "Find all mentions of project deadlines in Q3."
Fetch Full Section
After finding relevant content, YEOS can expand its search to include the surrounding context. This helps ensure the answer is accurate by seeing information in its full context rather than just isolated snippets.
How it works
When YEOS finds a promising section, it retrieves the broader content around it. This might include the page before and after, or the complete section that contains the answer. The extra context helps avoid misunderstandings.
When to use it
Use this when you need more than just a snippet. For example, if YEOS finds a paragraph about a policy, it might fetch the entire section so you can see related rules and exceptions.
Optional Tools
These tools are off by default but can be enabled if your team needs them. You can configure them from your organization settings.
Web Fetch
Web Fetch lets YEOS search the internet for up-to-date information that might not be in your documents. This is useful when you need current data, official guidelines, or information from external sources.
How it works
When enabled and relevant to your question, YEOS can browse trusted websites to gather additional information. It respects your configured restrictions and will avoid domains you have blocked.
When to use it
Use this when you need live data. For example, if your documents mention a regulatory change but you want to see the latest official guidance, or if you want YEOS to verify information against current sources.
Configuration Options
Maximum pages per fetch: Limits how many web pages YEOS will browse in a single response. Higher values give more comprehensive results but take longer.
Timeout: How long YEOS will wait for a web page to load before moving on. Lower values keep responses faster but might miss slow-loading sites.
Blocked domains: A blacklist of domains that YEOS will never visit, even if they appear relevant. Use this to exclude unreliable or inappropriate sources.
Best Practices
Use the blocklist for untrusted sources: Add any domains you do not want YEOS to visit, even if they appear relevant.
Review the blocklist regularly: Add any domains you know your team should not rely on for accurate information.
Keep max pages reasonable: A value of 3–5 is usually enough for most use cases. Higher values are better for research tasks where thoroughness matters more than speed.
Managing Tools
Tools can be configured by organization owners and admins from the Tools section in your organization settings.
Who can change tool settings: Only users with Owner or Admin roles can modify tool configurations. Regular team members can view the current settings but cannot make changes.
When changes take effect: Tool setting changes apply immediately to all future questions. Any conversations already in progress will not be affected.
Resetting to defaults: If you want to return to the default configuration, simply disable Web Fetch and save. The default settings will be restored automatically.
External Tools
External Tools let you connect your own APIs and services to YEOS. This allows agents to call external endpoints to retrieve data, perform actions, or integrate with your existing systems.
What are External Tools?
External Tools are custom API endpoints that you define. Each tool specifies a name, description, HTTP method, URL, input schema, headers, and authentication settings.
How They Work
When an agent decides to use an external tool, it formulates the appropriate parameters based on your question, YEOS sends an HTTP request to your endpoint, your API processes the request and returns a response, and the agent uses the response to formulate its answer.
Configuration Options
Endpoint — Select the HTTP method and enter the URL
Authentication — API key header, Bearer token, or none
Input Schema — Define parameters using JSON Schema
Best Practices
Write clear descriptions so agents know when to call the tool
Always use authentication for production APIs
Return helpful error messages for better agent responses
External Tool Collections
Collections are groups of related external tools that share common settings. They are especially useful when importing tools from an OpenAPI specification.
What are Collections?
A collection is a container for multiple external tools that share a common base URL, use the same authentication method, and are logically grouped.
OpenAPI Import
Import tools directly from an OpenAPI (Swagger) specification. YEOS parses the spec and creates tools automatically, preserving endpoint definitions and parameters.
Collections vs. Standalone Tools
Use Collections for multiple related endpoints from the same API
Use Standalone Tools for one-off, independent endpoints
Common Questions
Why are some tools always on?
Search Knowledge Base and Fetch Full Section are the core capabilities of YEOS. Without them, the system would not be able to find and present information from your documents. They cannot be disabled because they are essential to how YEOS works.
Can I enable only Web Fetch?
No. Web Fetch is optional, but it works in addition to the always-on tools. If you disable both always-on tools (which is not possible), you would not have a functional system.
What happens if I allow and block the same domain?
The blocklist takes priority. If a domain appears in both lists, YEOS will treat it as blocked and will not browse it.
Can team members see what tools were used?
Yes. In the conversation view, you can expand the thinking process section to see which tools YEOS used to generate its response.
Do tool settings apply to all conversations?
Yes. Tool settings are organization-wide and apply to all conversations within that organization. If you belong to multiple organizations, each can have different tool configurations.
Can external tools access my internal network?
External tools can call any URL that YEOS can reach. If your API is behind a firewall, you will need to allow traffic from YEOS servers or use a publicly accessible endpoint.
What happens if an external tool fails?
If a tool call fails (timeout, error response, or network issue), the agent will be informed and can either retry, try a different approach, or explain the failure to you.
Can I test external tools before enabling them?
Yes. When creating or editing a tool, you can invoke it with test parameters to verify it works correctly before enabling it for agents.