Please contact a Glean representative if you are interested in partnering with Glean and building tools on Glean’s platform.

Frequently Asked Questions (FAQs)

Which fields are interpreted by LLM?

The "Unique Identifier" and "Trigger Condition (including Example Queries)" fields are used by the LLM to identify which tool it should invoke/use for a user's query.

Make sure to give a detailed trigger condition and example queries, to ensure LLM knows exactly what user queries should this tool be used for.

How to authenticate Tools built using Glean's Jira template?

Please follow the steps described on this page to setup authentication for Jira: (

What are type hints?

Type hints are like instructions that help the Glean AI understand and work with different tools better. They're clues that tell the AI what each part of a tool does, making it easier for the AI to get the right information or do the right thing with those tools.

Benefits of Implementing Type Hints

  • Simplified Tool Creation: Type hints make it easier for developers to describe their tools' capabilities and requirements.
  • Better at Getting Information and Doing Tasks:
  • Type hints give clear instructions on gathering data or performing actions, leading to more accurate and relevant results from the AI.

How to Use Type Hints To use type-hints, consider the following steps:

  • Identify Relevant Type Hints: Review the list of supported type hints to determine which ones align with your tool's functionality.
  • Incorporate Type Hints into Your API Specs:
  • Add the selected type hints as structured details in your tool's API specifications.

Supported Type Hints

Below are the type hints currently supported by Glean:

  • EmailAddress

This type hint is used for fields that are intended to capture the email address of the user. Example usage:

  x-glean-typehint: 'EmailAddress'
  type: string
  description: User to which the issue is assigned.
  • Content

This hint is applied to fields that deal with large amounts of text or content. It's ideal for tools that generate, modify, or display content, ensuring that the information is handled appropriately. Example usage:

  x-glean-typehint: 'Content'
  type: string
  description: Rich description.
  • JiraProjectId

This type hint is for fields that require a JIRA project ID. It's used in contexts where actions or information are specific to a particular JIRA project, helping to ensure that operations are correctly scoped. Example usage:

  x-glean-typehint: 'JiraProjectID'
  type: string
  description: Project ID where the ticket is created.
  • JiraComponentId

This hint is designated for fields that involve a JIRA component ID. It's useful for tools that need to interact with specific components within a JIRA project, facilitating precise and relevant operations. Example usage:

  x-glean-typehint: 'JiraComponentId'
  type: string
  description: Component Id where the ticket should be filed.

By incorporating these type hints into your tool's API specifications, you can enhance the Glean AI assistant's understanding and handling of your tool, leading to a more seamless integration and a better overall user experience. If you have any further questions or require assistance, our developer support team is here to help.

Do Tools work for endpoints behind VPN?

Yes, please contact our team for information on how to do this.

How much data can my service return (for retrieval tools)?

The response from the service you're connecting to retrieve content using your retrieval tool will be sent to the LLM to create the final response. Hence, please ensure that the data returned is not larger than ~8000 characters. Depending on the LLM model being used, larger responses will be truncated from the end.